Straßenkartenkacheln

Roadmap-Kacheln sind Bildkacheln, die auf topografischen Vektordaten basieren mit dem kartografischen Stil von Google. Dazu gehören Straßen, Gebäude, Points of Interest und politische Grenzen.

Roadmap-Kacheln abrufen

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

Das folgende Codebeispiel zeigt eine typische Sitzungstokenanfrage für Roadmap-Kacheln.

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 Roadmap-Kacheln, indem Sie eine HTTPS-GET-Anfrage stellen, 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. Sein Wert gibt die Anzahl der Grad der Drehung des Kachelbilds gegen den Uhrzeigersinn an. orientation wird für roadmap Kacheln unterstützt sowie für Satelliten- und Geländeanfragen, bei denen die Basisbilder mit "overlay": true entfernt wurden und layerTypes festgelegt ist. Gültige orientation-Werte sind 0 (Standard), 90, 180 und 270.

Das Kachelkoordinatengitter wird nicht gedreht, wenn Sie einen orientation-Wert angeben. Wenn Sie beispielsweise orientation auf 90 setzen, 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 um 0 Grad	Ausrichtung um 90 Grad

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 Antwortnachricht vom Server. Stattdessen wird die Kachel mit den folgenden Statistiken in eine lokale Datei heruntergeladen.

  % 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.