Kachelschema

Alle mapx-Kacheln folgen dem gängigen Schema von Web-Karten. Wer MapLibre, Leaflet, OpenLayers oder QGIS nutzt, muss dazu nichts einstellen; für eigene Abfragen und Berechnungen steht hier das Wichtigste.

Projektion und Adresse

Die Welt wird in Web-Mercator (EPSG:3857) auf ein Quadrat abgebildet und in Zoomstufen unterteilt. Auf Stufe z hat das Quadrat 2^z × 2^z Kacheln. Eine Kachel wird mit z/x/y adressiert: x zählt von West nach Ost, y von Nord nach Süd (XYZ-Schema, nicht TMS), beide beginnen bei 0.

Kachel für einen Punkt lon, lat (Grad) auf Stufe z:

function kachel(lon, lat, z) {
  const n = 2 ** z;
  const x = Math.floor(((lon + 180) / 360) * n);
  const r = (lat * Math.PI) / 180;
  const y = Math.floor(((1 - Math.log(Math.tan(r) + 1 / Math.cos(r)) / Math.PI) / 2) * n);
  return { z, x, y };
}
kachel(12.694, 47.074, 12);   // { z: 12, x: 2192, y: 1439 }

Eine Kachel liefert der Endpunkt https://tiles.mapx.at/v1/tiles/{tileset}/{z}/{x}/{y}.{ext}, siehe Kacheln.

512-Pixel-Kacheln

Raster-Kacheln von mapx (Höhenmodelle, Orthophoto) haben 512 × 512 Pixel, nicht 256. Dadurch deckt eine 512er-Kachel dasselbe Gebiet ab wie vier 256er-Kacheln eine Stufe tiefer. Clients brauchen dafür die richtige Einstellung:

• MapLibre: tileSize: 512 (bei TileJSON automatisch).
• Leaflet: tileSize: 512, zoomOffset: -1.
• OpenLayers: tileSize: 512 an der Quelle.
• QGIS: Kachelauflösung 512.

Vergisst man das, wirkt die Karte um eine Zoomstufe versetzt und unscharf oder zu fein.

Auflösung je Zoomstufe

Die Auflösung hängt von der Breite ab. Die Tabelle gilt für 47,5° N, die Mitte Österreichs:

Eine Stufe tiefer halbiert die Pixelgröße. Die Höhenmodelle liegen bis z16 vor, das Orthophoto bis z18.

Overzoom

Ist eine Stufe höher als die gespeicherte, vergrößert der Client die Kacheln der höchsten Stufe (Overzoom). Das Bild wird dabei nicht schärfer, die Karte bleibt aber bedienbar. In MapLibre dazu maxzoom an der Quelle setzen auf die höchste vorhandene Stufe (aus TileJSON automatisch), die Karte selbst darf weiter zoomen. Abfragen außerhalb des Zoombereichs liefern 404, siehe Fehler und Limits.

Weiter

• Höhenwerte in Kacheln: Terrain-RGB.
• Koordinaten und Projektionen: Koordinaten.