📍Geocoding (Place → Coordinates)
Convert a place name into coordinates and location metadata via Open-Meteo's geocoding API: latitude, longitude, country, administrative region, timezone and population. The input every mapping/weather/travel agent needs first.
Worked examples
Berlin
GET /api/v1/live/geocode?city=Berlin&count=5&language=en
Result: Berlin, Germany — 52.52437, 13.41053
Springfield (ambiguous names)
GET /api/v1/live/geocode?city=Springfield&count=5&language=en
Result: Springfield, United States — 37.21533, -93.29824
Tokyo
GET /api/v1/live/geocode?city=Tokyo&count=3&language=en
Result: Tokyo, Japan — 35.6895, 139.69171
Machine API (x402)
$0.003 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/live/geocode?city=Berlin&count=5&language=en HTTP/1.1
Host: localhost:3000
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "live/geocode",
"input": {"city":"Berlin","count":5,"language":"en"},
"result": { "value": 5, "answer": "Berlin, Germany — 52.52437, 13.41053" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Geocoding turns place names into coordinates — the prerequisite for weather, distance, mapping and local-time tools. Powered by Open-Meteo's global geocoding database with multi-match disambiguation (country, region, population) and a configurable result language.
Frequently asked questions
Why do multiple cities share a name?
Springfield exists in dozens of US states. The results include country and region so the calling agent can pick the right one — or call again with a more specific name.
Can I search addresses?
This is place-level geocoding (cities, towns, islands). Full street-address geocoding needs a dedicated provider.