Address Lookup

Address lookup refers to the process of identifying the geographic coordinates, specifically latitude and longitude, associated with a specific address or location.

SecurityApiKeyAuth

Request

query Parameters

osm_ids required	Array of strings [ 1 .. 50 ] characters Comma-separated list of OSM ids each prefixed with its type, one of node(N), way(W) or relation(R). Up to 50 ids can be queried at the same time. Example: osm_ids=R146656,W104393803,N240109189
addressdetails	number Include a breakdown of the address into elements. Enum: 0 1
extratags	number Include additional information in the result if available, e.g. wikipedia link, opening hours. Enum: 0 1
namedetails	number Include a list of alternative names in the results. These may include language variants, references, operator and brand. Enum: 0 1
accept-language	string Preferred language order for showing search results, overrides the value specified in the Accept-Language HTTP header. Either use a standard RFC2616 accept-language string or a simple comma-separated list of language codes. Example: accept-language=en
polygon_geojson	number Output geometry of results as a GeoJSON. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_kml	number Output geometry of results as a KML. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_svg	number Output geometry of results as a SVG. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_text	number Output geometry of results as a WKT. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_threshold	number Return a simplified version of the output geometry. The parameter is the tolerance in degrees with which the geometry may differ from the original geometry. Topology is preserved in the result.

Responses

200

Reverse geocoding result.

400

Incorrect request parameters.

401

API key is incorrect or not provided.

402

Subscription daily limit exceeded.

403

Subscription suspended.

get/address/lookup

Request samples

curl
JavaScript
Ruby
Go
Python

Response samples

application/json

{"place_id": "string",
"licence": "string",
"osm_type": "node",
"osm_id": "string",
"lat": "string",
"lon": "string",
"display_name": "string",
"boundingbox": ["string",
"string",
"string",
"string"
],
"address": {"house_number": "string",
"road": "string",
"city": "string",
"county": "string",
"state": "string",
"postcode": "string",
"country": "string",
"country_code": "string"
}
}