Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url 'https://api.aisa.one/apis/v1/openmeteo/geocoding?name=Berlin' \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/openmeteo/geocoding \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/openmeteo/geocoding"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/openmeteo/geocoding', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/geocoding",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/openmeteo/geocoding"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/openmeteo/geocoding")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/openmeteo/geocoding")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"generationtime_ms": 0.5,
"results": [
{
"admin1": "Land Berlin",
"country": "Germany",
"country_code": "DE",
"country_id": 2921044,
"elevation": 74,
"feature_code": "PPLC",
"id": 2950159,
"latitude": 52.52437,
"longitude": 13.41053,
"name": "Berlin",
"population": 3426354,
"postcodes": [
"10967",
"13347"
],
"timezone": "Europe/Berlin"
}
]
}Open-Meteo
Open-Meteo Geocoding
Resolve place names or postal codes to coordinates, regions, timezone and population.
GET
https://api.aisa.one
/
apis
/
v1
/
openmeteo
/
geocoding
Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url 'https://api.aisa.one/apis/v1/openmeteo/geocoding?name=Berlin' \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/openmeteo/geocoding \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/openmeteo/geocoding"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/openmeteo/geocoding', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/geocoding",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/openmeteo/geocoding"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/openmeteo/geocoding")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/openmeteo/geocoding")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"generationtime_ms": 0.5,
"results": [
{
"admin1": "Land Berlin",
"country": "Germany",
"country_code": "DE",
"country_id": 2921044,
"elevation": 74,
"feature_code": "PPLC",
"id": 2950159,
"latitude": 52.52437,
"longitude": 13.41053,
"name": "Berlin",
"population": 3426354,
"postcodes": [
"10967",
"13347"
],
"timezone": "Europe/Berlin"
}
]
}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
{
"operationId": "get_openmeteo_geocoding",
"method": "GET",
"path": "/apis/v1/openmeteo/geocoding",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "Maximum number of results (1-100). Default 10.",
"in": "query",
"name": "count",
"required": false,
"schema": {
"default": 10,
"example": 5,
"type": "integer"
}
},
{
"description": "ISO-3166-1 alpha-2 country code to filter results.",
"in": "query",
"name": "countryCode",
"required": false,
"schema": {
"example": "DE",
"type": "string"
}
},
{
"description": "Response format. Default `json`.",
"in": "query",
"name": "format",
"required": false,
"schema": {
"default": "json",
"enum": [
"json",
"protobuf"
],
"type": "string"
}
},
{
"description": "Two-letter language code for translated names. Default `en`.",
"in": "query",
"name": "language",
"required": false,
"schema": {
"default": "en",
"example": "en",
"type": "string"
}
},
{
"description": "Location name or postal code. Append `, <country>` or `, <admin1>` to narrow results.",
"in": "query",
"name": "name",
"required": true,
"schema": {
"example": "Berlin",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_pricing": "fixed_success",
"default_request_estimate_usd": 0.0001,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Maximum number of results (1-100). Default 10.
Example:
5
ISO-3166-1 alpha-2 country code to filter results.
Example:
"DE"
Response format. Default json.
Available options:
json, protobuf Two-letter language code for translated names. Default en.
Example:
"en"
Location name or postal code. Append , <country> or , <admin1> to narrow results.
Example:
"Berlin"
Response
Matching locations.
The response is of type object.