Datenschnittstelle für Mapbox Vector Tiles

Mapbox Vector Tiles – Wie du viele Punkte und Linien auf die Karte bekommst

Stell dir vor, du hast eine riesige Karte und möchtest ganz viele Punkte, Linien oder Flächen darauf anzeigen – zum Beispiel Spielplätze, Wege oder Parks. Damit das schnell geht, gibt es „Mapbox Vector Tiles“. Das sind kleine Päckchen mit Kartendaten, die der Computer ganz schnell anzeigen kann.

Was brauchst du dafür?

Es muss vorher eingestellt werden, dass du solche Kartendaten abfragen darfst.
Du brauchst einen geheimen Schlüssel (Token), damit du die Daten bekommst.

Wie bekommst du die Daten?

Du schickst eine Nachricht an den Computer (API) und sagst:
„Bitte gib mir die Kartendaten als Vector Tiles!“

Die Adresse sieht so aus:

https://<URL>/mvt/v1/endpoints/<ENDPOINT-ID>/{z}/{x}/{y}.pbf

<ENDPOINT-ID> ist wie der Name deiner Schatzkiste.
{z}, {x}, {y} sind Zahlen, die zeigen, welches Stück von der großen Karte du gerade sehen willst.

Was ist eine Bounding Box?

Stell dir vor, du legst einen großen Rahmen um alle deine Schätze auf der Karte.
So weißt du genau, wo alles liegt.

So kannst du den Rahmen abfragen:

curl --request POST \
  --url https://<URL>/mvt/v1/endpoints/<ENDPOINT-ID> \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "bbox": true
  }'

Was ist Clustering?

Stell dir vor, auf deiner Karte sind ganz viele Punkte ganz nah beieinander.
Damit es nicht zu voll wird, kann man sie zu einem „Haufen“ (Cluster) zusammenfassen.
So sieht die Karte immer ordentlich aus!

Du kannst einstellen:

cluster: Sollen Punkte zu Haufen zusammengefasst werden?
clusterLines: Sollen auch Linien zu Haufen werden?
clusterPolygons: Sollen auch Flächen zu Haufen werden?
clusterItems: Sollen Infos zu den Sachen im Haufen angezeigt werden? (z.B. Name, Typ)
clusterMaxZoom: Bis zu welcher Zoomstufe soll geclustert werden?
clusterMinPoints: Wie viele Punkte braucht es mindestens für einen Haufen?
clusterMaxDistance: Wie weit dürfen die Punkte auseinander liegen, damit sie noch in einen Haufen kommen? (in Metern)

Beispiel: So sieht eine Anfrage aus

Mit JSON-Body:

POST https://<URL>/mvt/v1/endpoints/<ENDPOINT-ID>/{z}/{x}/{y}.pbf

{
  "cluster": true,
  "clusterLines": true,
  "clusterPolygons": true,
  "clusterItems": true,
  "clusterMaxZoom": 11,
  "clusterMinPoints": 2,
  "clusterMaxDistance": 1000
}

Mit URL-Parametern:

GET https://<URL>/mvt/v1/endpoints/<ENDPOINT-ID>/{z}/{x}/{y}.pbf?cluster=true&clusterLines=true&clusterPolygons=true&clusterItems=true&clusterMaxZoom=11&clusterMinPoints=2&clusterMaxDistance=1000

Noch wichtig zu wissen

Es werden nur Punkte, Linien oder Flächen angezeigt, die auch wirklich Koordinaten haben.
(Ohne Schatz auf der Karte gibt es keinen Punkt!)
Wenn du ganz viele Sachen auf einmal abfragst, kann es ein bisschen länger dauern, bis alles geladen ist.

Mit Mapbox Vector Tiles kannst du ganz viele Punkte, Linien und Flächen superschnell auf deiner Karte anzeigen – wie eine digitale Schatzsuche!