Loading
Loading
Convert any address, business name, or free-form place query into WGS84 latitude and longitude coordinates with detailed address components, bounding box, and POI data.
The Forward Geocoding API turns text descriptions of locations into structured geographic data. Accept free-form addresses, place names, landmarks, or business names and receive precise coordinates with full address components including street, postcode, city, state, country, and points of interest.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
formatoptionalStringdefault: jsonResponse format: 'json'.
queryrequiredStringFree form search query. Accepts addresses, place names, business names, landmarks.
limitoptionalIntegerdefault: 1Maximum number of results to return. Min 1, max 40.
min_latoptionalFloatMinimum latitude of the viewbox. Between -90 and 90, must be less than or equal to max_lat. All four viewbox parameters must be provided together.
max_latoptionalFloatMaximum latitude of the viewbox. Between -90 and 90, must be greater than or equal to min_lat. All four viewbox parameters must be provided together.
min_lonoptionalFloatMinimum longitude of the viewbox. Between -180 and 180, must be less than or equal to max_lon. All four viewbox parameters must be provided together.
max_lonoptionalFloatMaximum longitude of the viewbox. Between -180 and 180, must be greater than or equal to min_lon. All four viewbox parameters must be provided together.
The following headers can be used in your API requests.
Accept-LanguageoptionalStringdefault: enLanguage preference for results. Single code or comma-separated list. Falls back to English if needed.
A successful request returns a 200 OK response with a JSON array of matching locations. Each object contains the fields listed below. See the response preview on the right for the full JSON structure.
latLatitude of the matched location.
lonLongitude of the matched location.
nameName of the matched place.
categoryHigh-level category, e.g. amenity, place, natural, building, highway.
typeSpecific type within the category, e.g. fast_food, city, park, house_number.
streetStreet or road name.
areaNeighbourhood, suburb, district, or similar sub-city area.
postcodePostal code.
cityCity, town, or municipality.
countyCounty, district, shire, or prefecture.
state_codeISO 3166-2 subdivision code, e.g. US-TX.
stateState, region, province, or division.
country_codeISO 3166-1 alpha-2 country code in uppercase.
countryCountry name.
full_addressFull address as a single readable line.
bounding_boxSpatial extent of the feature: [lat_min, lat_max, lon_min, lon_max].
poi.name (String), poi.category (String), poi.type (String)
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
please pass correct parameters
Please provide a valid limit. Valid range is from 1 to 40.
Please provide a valid query string.
Latitude must be between -90 and 90.
Please provide all four viewbox parameters: min_lat, min_lon, max_lat, max_lon.
No results found for the given query.