Geocoding API

Geocoding API helps find the location coordinates of a known address, place, locality or administrative area, even if the query is incomplete or partly incorrect. It returns the complete postal address of the searched place along with relevant details.

Geocoding API is normally used in business workflows (likely machine-to-machine interactions) for handling full, incomplete, or unformatted addresses, and typos. For human-to-machine interaction - places/POIs search for both known or unknown places or for listing best known matches while the user is typing a query (letter-by-letter typing), use Discover, Browse or Autocomplete APIs for optimal results.

To make a Geocoding request use the following endpoint:

Request Parameters

Response Body

Sample Request

The following query geocodes an address in Massachusetts, Boston.

1
curl --location 'https://api.nextbillion.io/orbis/geocode?key=<your_api_key>&in=circle:42.3148375,-71.0353054;r=100&q=Columbia Point, Dorchester&in=countryCode:USA&lang=en-US&'

Sample Response

1
{
2
"items": [...]
3
}

API Query Limits

• NextBillion.ai allows a maximum rate limit of 2400 queries per minute or 40 queries/second for continuous requests.

API Error Codes