Straßenkartenkacheln

Entwickler im Europäischen Wirtschaftsraum (EWR)

Übersicht über die Roadmap-KachelStraßenkartenkacheln sind Bildkacheln, die auf topografischen Vektordaten mit dem kartografischen Stil von Google basieren. Dazu gehören Straßen, Gebäude, POIs und politische Grenzen.

Roadmap-Kacheln abrufen

Nachdem Sie ein Sitzungstoken erhalten haben, können Sie Anfragen für Roadmap-Kacheln stellen. Da sich das Sitzungstoken auf die gesamte Sitzung bezieht, müssen Sie die Kartenoptionen nicht mit Ihren Kachelanfragen angeben.

Das folgende Codebeispiel zeigt eine typische Anfrage für ein Sitzungstoken für Straßenkartenkacheln.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Sie erhalten Straßenkartenkacheln, indem Sie eine HTTPS-GET-Anfrage senden, wie im folgenden Beispiel gezeigt.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

In dieser HTTPS-GET-Anfrage ist z die Zoomstufe (zwischen 0 und 22) und x und y sind die Kachelkoordinaten der Kachel, die Sie abrufen möchten.

Der Parameter orientation ist optional. Der Wert gibt die Anzahl der Grad an, um die das Kachelbild gegen den Uhrzeigersinn gedreht wird. orientation wird für roadmap-Kacheln unterstützt. Außerdem wird es für Satelliten- und Geländeanfragen unterstützt, bei denen die Basisbilder mit "overlay": true entfernt und layerTypes festgelegt wurde. Gültige orientation-Werte sind 0 (Standard), 90, 180 und 270.

Das Kachelkoordinatengitter wird nicht gedreht, wenn Sie einen orientation-Wert angeben. Wenn Sie orientation beispielsweise auf 90 Grad festlegen, wird die Position der Kachel von links nach rechts weiterhin durch die x-Koordinate definiert, die in diesem Fall von Norden nach Süden auf der Karte verläuft.

Ausrichtung bei 0 Grad Ausrichtung um 90 Grad
Ausrichtung bei 0 Grad Ausrichtung um 90 Grad

Beispiel für eine Kachelanfrage

Im folgenden Beispiel wird eine einzelne Kachel angefordert, die die gesamte Welt enthält. In diesem Beispiel ist die Zoomstufe 0 und die x- und y-Koordinaten sind 0, 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

In diesem Beispiel gibt es keine Antwortnachricht vom Server. Stattdessen wird die Kachel mit den folgenden Statistiken in eine lokale Datei heruntergeladen.

Die ganze Welt in einer Kachel

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

Informationen zu Antwortnachrichtenheadern finden Sie unter Inhalte vorab abrufen, zwischenspeichern oder speichern.