--- title: "Find places and addresses near a location point (reverse geocoding)." method: GET path: "/geocoding/v2/reverse" tags: ["Geocoding"] --- # Find places and addresses near a location point (reverse geocoding). `GET /geocoding/v2/reverse` Reverse geocoding and search finds places and addresses near any geographic coordinates. ## Query parameters - `point.lat` number, double, required — Latitude in decimal degrees. - `point.lon` number, double, required — Longitude in decimal degrees. - `layers` LayerId[] - `sources` SourceId[] - `boundary.gid` string — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `boundary.country` string[] - `boundary.circle.radius` integer — A radius, measured in kilometers. - `size` integer — The maximum number of items to return. - `lang` string ## Response `200` A GeoJSON FeatureCollection with the results - GeocodeResponseEnvelopePropertiesV2 — The GeoJSON response envelope. This is parameterized over the feature properties type to allow for changes between versions. - `bbox` number[], nullable — The geographic bounding box covering all features in the result set. This is empty for autocomplete results. - `features` FeaturePropertiesV2[], required - `bbox` number[], nullable - `geometry` Point — A point geometry in GeoJSON format. - `coordinates` number[], required - `type` string, required - `properties` object, required — The GeoJSON properties object. - `addendum` AddendumV2 — Miscellaneous data that doesn't quite fit anywhere else in the record. - `foursquare` FoursquareAddendum - `tel` string, nullable - `website` string, nullable - `geonames` GeonamesAddendum - `feature_code` string, required — The GeoNames feature code (for GeoNames results only). - `osm` OpenStreetMapAddendum — OpenStreetMap-specific additional fields. These values are exactly as they appear in the associated OSM tag. - `brand` string, nullable — The principal brand of goods/services sold at a place, or the common identity for individually owned and operated stores. - `iata` string, nullable — IATA airport code. - `icao` string, nullable — ICAO airport code. - `opening_hours` string, nullable — The opening hours of the place, in the OSM Opening Hours specification. See https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification for details. - `operator` string, nullable — The company, corp, person, or other entity directly in charge of operating something. This is often used for public transport, hotels, restaurants, and postal services. See https://wiki.openstreetmap.org/wiki/Key:operator for details - `phone` string, nullable - `website` string, nullable - `wheelchair` string, nullable — Is this place wheelchair accessible? - `wikidata` string, nullable — Wikidata concordance ID. - `wikipedia` string, nullable — Wikipedia concordance ID. - `whosonfirst_concordances` WhosOnFirstConcordances - `eurographics_gisco_id` string, nullable - `faa_code` string, nullable - `factual_id` string, nullable - `fifa_id` string, nullable - `fips_code` string, nullable - `fr_gov_epci_code` integer, nullable — An Open Data France EPCI code. - `fra_insee_code` integer, nullable — Institut national de la statistique et des études économiques (Insee) code - `geonames_id` integer, nullable - `geoplanet_id` integer, nullable - `hasc_id` string, nullable — A Statoids HASC ID. - `iata_code` string, nullable - `icao_code` string, nullable - `itu_id` string, nullable - `karmashapes_id` string, nullable - `natural_earth_id` integer, nullable - `nuts_2021_id` string, nullable — A Eurostat NUTS 2021 ID - `quattroshapes_id` integer, nullable - `quattroshapes_pg_id` integer, nullable — A Quattroshapes Point Gazetteer ID. - `us_census_geo_id` integer, nullable - `wikidata_id` string, nullable - `wikipedia_page` string, nullable - `address_components` AddressComponentsV2 — Structured address components. - `cross_street` string, nullable — The cross street address component (rarely used). - `number` string, nullable — The house / building number. Note that, despite the name, this is not strictly numeric. Values such as 30-1 and 11A may be valid building/house numbers in some areas. - `postal_code` string, nullable — The postal code. - `street` string, nullable — The street component of the address. - `unit` string, nullable — The unit number (where available). - `coarse_location` string, nullable — The coarse-grained location of the place (e.g. Seoul, South Korea). In search experiences, this is typically the second line of a result cell. - `confidence` number, double, nullable — The level of confidence (0.0 - 1.0) that the result is what you actually searched for. This is not necessarily the same as relevance (results are returned sorted by relevance already), but rather how closely the explicit or inferred components match the result. This is only present for forward geocoding responses (not autocomplete or place details). - `context` Context — The geographic context for a feature. Note that while data sources and country codes are listed, this does not *necessarily* mean that the view is a specific hierarchy endorsed by that source. We generally attempt to present the same view as OpenStreetMap. Contact us if your use case requires a specific political view of the world. - `iso_3166_a2` string, nullable — The ISO 3166-1 alpha-2 country code in which the feature is located. - `iso_3166_a3` string, nullable — The ISO 3166-1 alpha-3 country code in which the feature is located. - `whosonfirst` WofContext, required - `borough` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `continent` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `country` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `county` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `dependency` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `localadmin` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `locality` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `macrocounty` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `macroregion` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `marinearea` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `neighbourhood` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `ocean` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `region` WofContextComponent - `abbreviation` string, nullable - `gid` string, required — A globally unique identifier for a feature. Note: these are not stable for all datasets! For example, OSM features may be deleted and re-added with a new ID. Others like Who's on First guarantee stability long term. - `name` string, required - `distance` number, double, nullable — The distance from the search focus point, in kilometers. - `formatted_address_line` string — The address formatted as a single line, following local postal conventions for ordering and separators. - `formatted_address_lines` string[] — Address components split up into lines, following local postal conventions for ordering and separators. - `gid` string, required — The globally unique identifier for this result. You can use this to uniquely identify a place, and to get the full details from the place details endpoint. NOTE: While GIDs are unique, they may not necessarily be stable in all datasets. - `layer` string, required — The data layer containing the place (e.g. "address" or "poi"). - `match_type` 'match' | 'interpolated' | 'fallback' - `name` string, required — The best name for the place, accounting for request language preferences. When building an autocomplete search experience, this is the primary display string. - `precision` 'point' | 'centroid', required — The level of detail for the geometry. - `sources` SourceAttribution[] — A list of sources from which the result is derived. - `fixit_url` string, nullable — A URL where you can submit changes to the source data for a place (e.g. edit on OpenStreetMap, Foursquare Placemaker, etc.). - `source` string, required — The source identifier. - `source_id` string, required — The ID of the record as it appears in the original source. - `type` string - `geocoding` GeocodingMeta, required - `attribution` string, required - `error` string, nullable — Errors encountered serving the request (if any). - `query` object, nullable — An object containing all valid, parsed query parameters. For example, this will contain text and possibly other parameters for an autocomplete query. This will not be present for invalid requests. - `type` string, required — The GeoJSON object type as defined in RFC 7946. NOTE: This is always FeatureCollection, as the response envelope is designed to hold multiple results. ## Other responses - `400` — A response with a description of why the request is malformed - `500` — A response with a description of what went wrong internally --- [API](https://skmtc.net/stadiamaps/apis/stadia-maps-geospatial-apis.md) · [All operations](https://skmtc.net/stadiamaps/apis/stadia-maps-geospatial-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stadiamaps/stadia-maps-geospatial-apis/versions/99e0701a73aa/schema)