maps/geocode

Convert an address or place name into geographic coordinates.

0.1 credits / call ($0.0001)

charged on success

What it does

Resolves a free-text address or place name into geographic coordinates and a ranked set of structured candidate matches (street, city, region, country, postcode).

Primary use cases

Turning a user-entered address into latitude and longitude.
Resolving a place name to feed into routing or other location tools.
Standardizing messy address input into structured components.

Good to know

Narrow results with filter (e.g. "countrycode:us" or "rect:lon1,lat1,lon2,lat2") and rank by nearness with bias (e.g. "proximity:lon,lat"). Use type to restrict the result level (country, state, city, postcode, street, amenity). Returns up to limit candidates.

Parameters

biasstringoptional

Bias ranking toward a location, e.g. "proximity:lon,lat".

langstringoptional

2-letter language code for result names (e.g. "en").

textstringrequired

Address or place name to geocode.

typestringoptional

Restrict to a result level.

limitintegeroptionaldefault: 5

Number of candidate results (1-20).

filterstringoptional

Restrict results, e.g. "countrycode:us,ca" or "rect:lon1,lat1,lon2,lat2" or "circle:lon,lat,meters".