GET/geocoding/lookupapiKey1 credit/request
Looks up OpenStreetMap objects by the required `osm_ids`, a comma-separated list prefixed `N` (node), `W` (way) or `R` (relation), such as `W34633854,N123`. Each place has its display name, category and type, coordinates, bounding box, importance and address parts; `addressdetails` defaults to true, and `extratags`, `namedetails` and `accept_language` are optional. Malformed ids return `400`; no match returns `404`.
Required: osm_ids. Optional: accept_language, addressdetails, extratags, namedetails.
Sampled 14 Oct 2026: 1 item. Filled in every item: place_id, licence, osm_type, osm_id, lat, lon, category, type and 7 more. In the sample: licence: “Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org…”; display_name: median 138 characters; boundingbox: median 4 entries; osm_type: “way”; category: “office”; type: “yes”; addresstype: “office”; name: “Empire State Building”.
Open in Playground
GET/geocoding/reverseapiKey1 credit/request
Returns the nearest OpenStreetMap place for the required `lat` and `lon`. `zoom` (0 to 18, default 18) sets the level of detail; `addressdetails` defaults to true, and `extratags`, `namedetails` and `accept_language` are optional. The place has its display name, category and type, OSM type and id, bounding box, importance and address parts. Out-of-range coordinates return `400`; no place found returns `404`.
Required: lat, lon. Optional: zoom, accept_language, addressdetails, extratags, namedetails.
Sampled 14 Oct 2026: 14 fields returned with a value, 1 empty (name). In the sample: place_rank: 30; licence: “Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org…”; display_name: 115 characters; boundingbox: 4 entries; osm_type: “node”; category: “tourism”; type: “viewpoint”; importance: 0.
Open in Playground
GET/geocoding/searchapiKey1 credit/request
Searches OpenStreetMap places by address. Pass either free-text `q` or structured fields (`street`, `city`, `county`, `state`, `country`, `postalcode`), not both. `limit` defaults to 10 and is clamped to 20; `countrycodes` restricts by ISO 3166-1 alpha-2 country. Each result has its display name, coordinates, category, type, bounding box, importance and address parts. No match returns `404`.
Optional: q, street, city, county, state, country, postalcode, limit, countrycodes, accept_language, addressdetails, extratags, namedetails.
Sampled 14 Oct 2026: 1 item. Filled in every item: place_id, licence, osm_type, osm_id, lat, lon, category, type and 7 more. In the sample: licence: “Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org…”; display_name: median 138 characters; boundingbox: median 4 entries; osm_type: “way”; category: “office”; type: “yes”; addresstype: “office”; name: “Empire State Building”.
Open in Playground