Kachel-Endpunkte

Karten werden in Kacheln ausgeliefert, adressiert über Zoomstufe z und die Kachelkoordinaten x/y (Schema). Zwei Arten: Vektorkacheln aus einem Kachelsatz, Rasterkacheln aus einem Style.

Vektorkacheln

GET https://tiles.pixelmap.at/data/{kachelsatz}/{z}/{x}/{y}.pbf

curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/data/planet/1/1/0.pbf" --output kachel.pbf
curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/data/boundary/1/1/0.pbf" --output grenzen.pbf

Format ist Mapbox Vector Tile (MVT), ausgeliefert als Protobuf.

{kachelsatz} ist das Feld id aus data.json — welche Sätze es gibt, steht unter Datenquellen.

Einige Kachelsätze liefern statt MVT ein Bildformat — hillshade und slope als PNG (Zoom 7–11), mapterhorn als WebP. Was ein Satz liefert, steht in seinem TileJSON unter format:

curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/data/mapterhorn/10/545/359.webp" --output relief.webp

Rasterkacheln aus einem Style

Für Clients, die keine Vektorkarten zeichnen, rendert der Server jeden Style serverseitig zu Bildern:

GET https://tiles.pixelmap.at/styles/{style}/{z}/{x}/{y}.{format}
GET https://tiles.pixelmap.at/styles/{style}/{z}/{x}/{y}@2x.{format}

Gemessen verfügbar: png, jpg, webp — jeweils auch in der @2x-Variante für Bildschirme mit hoher Pixeldichte.

curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/styles/pp-street/14/8792/5867.png"    --output kachel.png
curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/styles/pp-street/14/8792/5867@2x.png" --output kachel@2x.png
curl -H "Authorization: Bearer <IHR-TOKEN>" "https://tiles.pixelmap.at/styles/pp-street/14/8792/5867.webp"   --output kachel.webp

Die Formate unterscheiden sich deutlich in der Größe — dieselbe Kachel gemessen: PNG 1,8 kB, JPEG 652 B, WebP 200 B, PNG@2x 6,3 kB. WebP ist die sparsamste Wahl, wenn Ihre Zielgruppe es unterstützt.

Zoomgrenzen

Jeder Kachelsatz hat einen Zoombereich (minzoom/maxzoom im TileJSON). Eine Anfrage außerhalb davon beantwortet der Server mit 404, nicht mit einer leeren Kachel — contour beginnt zum Beispiel erst bei Zoomstufe 11 (gemessen: z10 → 404, z11 → 200, z14 → 404), hillshade und slope bei 7.

Das ist beim Aufbau einer Karte der häufigste Grund für „Kacheln fehlen in der Übersicht, erscheinen beim Hineinzoomen”. Kein Fehler, sondern der Zoombereich der Quelle.