latlong_to_quadkey: Convert latitude/longitude coordinates into QuadKeys

In quadkeyr: Generate Raster Images from QuadKey-Identified Datasets

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)

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

Value

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

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
)

quadkeyr documentation built on April 3, 2025, 8:52 p.m.