Skip to main content
GET
Geocoding Search
Search a place name or postal code and resolve it to coordinates and metadata. Narrow results by appending , <country> to name, filtering with countryCode, or capping the result count with count. Translated names are available via language. The response contains a results array; each entry includes id, name, latitude, longitude, elevation, feature_code, country/country_code, hierarchical admin1admin4, timezone, population and postcodes. Example: GET /apis/v1/openmeteo/geocoding?name=Berlin&count=5&language=en. Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

name
string
required

Location name or postal code. Append , <country> or , <admin1> to narrow results.

Example:

"Berlin"

count
integer
default:10

Maximum number of results (1-100). Default 10.

Example:

5

language
string
default:en

Two-letter language code for translated names. Default en.

Example:

"en"

countryCode
string

ISO-3166-1 alpha-2 country code to filter results.

Example:

"DE"

format
enum<string>
default:json

Response format. Default json.

Available options:
json,
protobuf

Response

200 - application/json

Matching locations.

The response is of type object.