FAQ: frequently asked questions about mapx
Answers to the most common questions about token, cost, license, data and errors. The detailed version is in the FAQ of the documentation.
Do I need a token or an account?
Yes, a free account and an API token. Register at account.mapx.at, create a token and send it as Authorization: Bearer (servers) or access_token (browsers, images). CORS is open. Details: Access and limits.
What does mapx cost?
Nothing. Access is free, rate limits apply per token and zone.
May I use it commercially?
Yes. The data is licensed under CC BY 4.0: you name the source, everything else is free. The attribution must be visible to the users of the map, not only in the imprint.
Does mapx use OpenStreetMap?
No. mapx is built exclusively on official open data, for example from BEV, GIP.at, ASFINAG and GeoSphere Austria.
How current is the data?
Each tileset has a source date. It is shown on its page under Tilesets and in the stand field of GET /v1/tiles.
Does a URL change when there is new data?
No. API URLs and TileJSON stay the same. PMTiles file names contain the date, so old files stay valid. Through the TileJSON you always reach the current file.
Is there data outside Austria?
No, Austria only. Orthophoto and basemap extend a little into the neighboring countries at the border.
Can I use the maps offline?
Yes. Download a PMTiles file and serve it yourself, see Self-host PMTiles and QGIS.
Is the cadastre legally binding?
No. It shows parcel boundaries for orientation and replaces neither a land register extract nor a survey. More on the page Cadastre and parcels.
What is the difference between DTM and DSM?
The DTM is bare ground, the DSM includes trees and buildings. Use the DTM for gradients and profiles, the DSM for visibility and building heights. More on the page Elevation and terrain.
Why do I get 401 or 403?
401 means the token is missing, invalid or expired. 403 means the token is blocked, or a public token is used from an origin or app that is not allowed (origin-not-allowed). The code in the error body names the reason.
Why do I get 429?
You exceeded the rate limit of the zone. Wait the seconds given in Retry-After and retry with a growing delay. For heavy loads PMTiles help.
My points land in the wrong country.
Longitude and latitude are swapped. mapx and GeoJSON use lon,lat, longitude comes first.
My map is blurry.
Raster tiles are 512 pixels. Set tileSize: 512 in your client.
Where do I report a problem?
Write to support@mapx.at for technical questions and bugs or to info@mapx.at for everything else.