Skip to main content
GET
Reference example
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 admin1–admin4, timezone, population and postcodes. Example: GET /apis/v1/openmeteo/geocoding?name=Berlin&count=5&language=en. Billing: per call, metered per request. Current prices are on aisa.one/api. 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.

Request contract

  • Method and path: GET /apis/v1/openmeteo/geocoding
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/openmeteo/geocoding
  • count: query; optional
  • countryCode: query; optional
  • format: query; optional
  • language: query; optional
  • name: query; required
  • Runtime facts: sha256:36f55c225a89aa6e29290270a8eeed85c6f6224160884d7fa3a086ea2ad602ef
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0001
  • Cost contract: fixed_success
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

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

Query Parameters

count
integer
default:10

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

Example:

5

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
language
string
default:en

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

Example:

"en"

name
string
required

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

Example:

"Berlin"

Response

Matching locations.

The response is of type object.