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.
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.
poiPoints of interest at or near the location.
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].
Each object in the poi array contains the following fields:
poi[].nameName of the point of interest.
poi[].categoryPOI category.
poi[].typeSpecific type within the POI category.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
please pass correct parameters
Please provide a valid limit. Valid range is from 1 to 40.
No results found for the given query.