Skip to content
GuidesPlaygroundDashboard

Reverse geocode a coordinate

GET/api/v1/geocode/reverse

Reverse geocode a coordinate

Query ParametersExpand Collapse
lat: number

Latitude

lng: number

Longitude

lang: optional string

Language code for localized names (e.g. en, de, fr)

layer: optional string

Filter by layer: house or poi

limit: optional number

Maximum results (default 1, max 20)

radius: optional number

Search radius in meters (default 200, max 5000)

ReturnsExpand Collapse
ReverseGeocodeResult = object { features, type }

GeoJSON FeatureCollection of reverse geocoding results

features: array of GeocodingFeature { geometry, properties, type }
geometry: GeoJsonGeometry { coordinates, type }
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

One of the following:
array of number
array of array of number
array of array of array of number
array of array of array of array of number
type: "Point" or "LineString" or "Polygon" or 3 more
One of the following:
"Point"
"LineString"
"Polygon"
"MultiPoint"
"MultiLineString"
"MultiPolygon"
properties: object { country_code, display_name, distance_m, 4 more }
country_code: optional string

ISO 3166-1 alpha-2 country code

display_name: optional string

Formatted address or place name

distance_m: optional number

Distance in meters

osm_id: optional number

OpenStreetMap ID

osm_type: optional string

OSM element type

score: optional number

Match confidence score

source: optional string

Result source (address, place, interpolation)

type: "Feature"
type: "FeatureCollection"

Reverse geocode a coordinate

curl https://plaza.fyi/api/v1/geocode/reverse \
    -H "Authorization: Bearer $PLAZA_API_KEY"
Returns Examples