Geocoding API for Austria: address search, autofill and validation
The geocoding API turns addresses and place names into coordinates and coordinates into the nearest address. It also offers suggestions while typing, address autofill for forms and address validation. It is meant for developers who want to search, complete or check addresses in Austria in websites, apps and backends.
What the API can do
GET /v1/geocode: forward geocoding of addresses, streets, places, postcodes, districts and parcels. Road kilometers such asA1 km 41can be searched as well.GET /v1/reverse: reverse geocoding, the nearest address, street or place to a point.POST /v1/geocode/batch: up to 1000 requests in one call.GET /v1/searchbox/suggestand/v1/searchbox/retrieve/{id}: suggestions while typing and details of the chosen result.GET /v1/autofill/suggestand/v1/autofill/retrieve/{id}: address autofill with separate fields for street, house number, postcode and place.GET /v1/address/validate: address validation with the statusmatch,corrected,ambiguousornot_found.
Example
Turn an address into coordinates:
curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/geocode?q=Herrengasse%2013%20Wien&limit=3&types=address" | jqconst res = await fetch("https://api.mapx.at/v1/geocode?q=Herrengasse%2013%20Wien&limit=3&types=address", { headers: { Authorization: "Bearer YOUR_TOKEN" } });
const data = await res.json();The nearest address to a point (coordinates are always lon,lat):
curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/reverse?lng=16.3725&lat=48.2085&limit=1&types=address" | jqValidate an address:
curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/address/validate?q=Herrengasse%2013,%201010%20Wien" | jqWhere the data comes from
Addresses, geographic names, administrative boundaries and cadastre come from the Federal Office of Metrology and Surveying (BEV) and are licensed under CC BY 4.0. The autofill uses only the official address register of the BEV. Points of interest in the search come from official sources, not from OpenStreetMap.
Limitations
- Austria only.
- The search falls into the zone
searchwith 10 requests per second per token, the batch request into the zoneheavywith 30 requests per minute. When you exceed a limit the API answers429withRetry-After. - The batch request takes at most 512 KB and 1000 requests per call.
- Always pass
typesto keep queries cheap. - Address validation compares with the official register. For
ambiguousit returns up to 5 candidates instead of one address. - The source must be shown visibly, JSON responses carry an
attributionfield for this.
Get started
Access is free with an account and a token. All endpoints and parameters are in the geocoding API reference, the address search guide and the autofill and validation reference.