Error

A valid request URL is required to generate request examples

{
  "lat": 123,
  "lon": 123,
  "message": "<string>"
}

Tools

Single Address Geocoding

Pro AI

Converts an address into geographic coordinates. This endpoint takes a free-text location or address and returns the most likely latitude and longitude. It is designed specifically for Agentic usage where only a single definitive location is needed.

To increase location accuracy, it is highly encouraged to provide as precise and complete an address as possible. Providing an optional two-letter country code (e.g., “us”) is also strongly encouraged to increase accuracy. Returns null coordinates and an explanatory message if no results are found.

GET

/

tools

/

geocode-single

Error

A valid request URL is required to generate request examples

{
  "lat": 123,
  "lon": 123,
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Your access token or API key. Pass as Authorization: Bearer <token>.

Query Parameters

query

string

required

The address or location query to geocode. e.g., '1600 Pennsylvania Ave NW, Washington, DC'

country

string | null

Optional two-letter country code (ISO 3166-1 alpha-2) to improve geocoding accuracy.

Required string length: 2

Response

Successful Response

Response schema for single geocoding.

lat

number | null

Latitude of the location. Null if no results found.

lon

number | null

Longitude of the location. Null if no results found.

message

string | null

Additional information, such as error messages if no results were found.

Fire Risk Score

⌘I