GET /
Returns the machine-readable documentation this page is rendered from. Free, and everything an agent needs.
GeoDB Cities
by
API3FreeAirnode v0.1.0
GeoDB Cities is a reference database of the world's cities, regions and countries: population, coordinates, elevation, time zone, currency and the administrative hierarchy each place sits in. This Airnode wraps its read endpoints, so a consumer receives a city's population or a country's regions with a signature saying this Airnode obtained it from GeoDB at this time.
A place is addressed by an identifier, either a GeoNames numeric id or a WikiData id such as Q60, and a country by its ISO code such as US. Names are matched by prefix and word by word rather than searched, so findCities is where an identifier is found before the rest of the operations are asked anything.
The data is refreshed from GeoNames, licensed CC BY, and WikiData, released CC0. Attribution to those two is the whole of the obligation that comes with using it.
Every response carries an EIP-191 signature from the Airnode that served it, so the data can be attributed back to its source rather than trusted on reputation.
Interface
Served at https://airnode-geodb.fly.dev/. The two requests below are everything the endpoint speaks, and each can be sent from this page. What comes back is verified right here in the browser.
POST /
Names an operation and its parameters, performs it against the upstream API, and answers with the response and the attestation over it.
Verify the response
Every response is signed by the API that served it. Paste one to check it really came from this listing and was not altered along the way.