quadkeyr (version 0.1.0)

latlong_to_quadkey: Convert latitude/longitude coordinates into QuadKeys

Description

Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into a Quadkey at a specified zoom level. For further information, refer to the Microsoft Bing Maps Tile System documentation.

Usage

latlong_to_quadkey(lat, lon, zoom)

Value

A dataframe with latitude (lat), longitude (lon), zoom level (zoom) and the QuadKey as a string (quadkey).

Arguments

lat

Latitude of the point, in degrees.

lon

Longitude of the point, in degrees.

zoom

Zoom or level of detail, from 1 (lowest detail) to 23 (highest detail).

Details

Converting latitude/longitude coordinates into a QuadKey and then back to latitude/longitude won't yield identical values, unless the initial latitude/longitude coordinates correspond to the upper-left Quadkey's pixel and tile XY coordinates at the same zoom level.

Understanding this distinction is crucial for the accurate use of these functions in coordinate conversions.

For a detailed explanation on how to use this and other similar quadkeyr functions, read the the vignette: https://docs.ropensci.org/quadkeyr/articles/quadkey_to_sf_conversion.html

References

https://learn.microsoft.com/en-us/bingmaps/articles/bing-maps-tile-system

Examples

latlong_to_quadkey(
  lat = 35.63051,
  lon = 139.69116,
  zoom = 20
)
latlong_to_quadkey(
  lat = c(-4, -25.33, -25.66),
  lon = c(-53, -60.33, -70.66),
  zoom = 4
)