Roadmap-Kacheln sind Bildkacheln, die auf topografischen Vektordaten im kartografischen Stil von Google basieren. Dazu gehören Straßen, Gebäude, POIs und politische Grenzen.
Straßenkartenkacheln abrufen
Sie können mit Anfragen für Roadmap-Kacheln beginnen, 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 veranschaulicht eine typische Anfrage eines Sitzungstokens 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 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 die Kachelkoordinaten der Kachel, die Sie abrufen möchten.
Der Parameter orientation ist optional. Der Wert gibt die Grade der Drehung des Kachelbilds gegen den Uhrzeigersinn an. orientation wird für roadmap-Kacheln sowie für Satelliten- und Geländeanfragen unterstützt, bei denen Basisbilder mit "overlay": true entfernt und layerTypes festgelegt wurde. Gültige orientation-Werte sind 0 (Standardeinstellung), 90, 180 und 270.
Das Koordinatenraster der Kachel wird nicht gedreht, wenn Sie einen orientation-Wert angeben. Wenn Sie beispielsweise orientation auf 90 setzen, definiert die Koordinate x trotzdem die rechtsläufige Position der Kachel, also von Norden nach Süden auf der Karte.
| Null-Grad-Ausrichtung | 90-Grad-Ausrichtung |
|---|---|
 |
 |
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 Antwort vom Server. Stattdessen lädt die Kachel in eine lokale Datei mit den folgenden Statistiken herunter.
% 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 Antwort-Nachrichtenheadern finden Sie unter Prefetch, Caching oder Speicherung von Inhalten.