Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference
Geocode

Reverse geocode a coordinate

geocode.reverse(**kwargs) -> ReverseGeocodeResult { features, type }
GET/api/v1/geocode/reverse

Reverse geocode a coordinate

ParametersExpand Collapse
lat: Float

Latitude

lng: Float

Longitude

lang: String

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

layer: String

Filter by layer: house or poi

limit: Integer

Maximum results (default 1, max 20)

radius: Integer

Search radius in meters (default 200, max 5000)

ReturnsExpand Collapse
class ReverseGeocodeResult { features, type }

GeoJSON FeatureCollection of reverse geocoding results

features: Array[GeocodingFeature { geometry, properties, type } ]
geometry: GeoJsonGeometry { coordinates, type }
coordinates: Array[Float] | Array[Array[Float]] | Array[Array[Array[Float]]] | Array[Array[Array[Array[Float]]]]

GeoJSON coordinates array (nesting depth varies by geometry type)

One of the following:
Array[Float]
Array[Array[Float]]
Array[Array[Array[Float]]]
Array[Array[Array[Array[Float]]]]
type: :Point | :LineString | :Polygon | 3 more
One of the following:
:Point
:LineString
:Polygon
:MultiPoint
:MultiLineString
:MultiPolygon
properties: { country_code, display_name, distance_m, 4 more}
country_code: String

ISO 3166-1 alpha-2 country code

display_name: String

Formatted address or place name

distance_m: Float

Distance in meters

osm_id: Integer

OpenStreetMap ID

osm_type: String

OSM element type

score: Float

Match confidence score

source: String

Result source (address, place, interpolation)

type: :Feature
type: :FeatureCollection

Reverse geocode a coordinate

require "plaza"

plaza = Plaza::Client.new(
  api_key: "My API Key",
  environment: "local" # defaults to "production"
)

reverse_geocode_result = plaza.geocode.reverse(lat: 0, lng: 0)

puts(reverse_geocode_result)
Returns Examples