Straßenkartenkacheln

Ü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

Sobald Sie ein Sitzungstoken erhalten haben, können Sie Anfragen für Roadmap-Kacheln stellen. Da das Sitzungstoken für die gesamte Sitzung gilt, müssen Sie die Kartenoptionen nicht mit Ihren Kachelnanfragen angeben.

Das folgende Codebeispiel zeigt eine typische Anfrage für ein Sitzungstoken für Infokarten.

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 können eine HTTPS-GET-Anfrage senden, um Kartenkacheln für die Roadmap abzurufen, 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 (von 0 bis 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 Kachelnbild gegen den Uhrzeigersinn gedreht werden soll. orientation wird für roadmap-Kacheln und für Satelliten- und Geländeanfragen unterstützt, bei denen Basisbilder mit "overlay": true entfernt wurden und layerTypes festgelegt ist. Gültige Werte für orientation sind 0 (Standard), 90, 180 und 270.

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

Ausrichtung auf 0 Grad 90-Grad-Ausrichtung
Ausrichtung auf 0 Grad 90-Grad-Ausrichtung

Beispiel für eine Kachelanfrage

Betrachten Sie das folgende Beispiel, in dem eine einzelne Kachel angefordert wird, 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 Antwort vom Server. Stattdessen wird die Kachel mit den folgenden Statistiken in eine lokale Datei heruntergeladen.

Die ganze Welt auf 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.