Roadmap-Kacheln 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 erhalten
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 zeigt eine typische Sitzungstoken-Anfrage 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"
Um Roadmap-Kacheln zu erhalten, stellen Sie eine HTTPS-GET-Anfrage, 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 abzurufenden Kachel.
Der Parameter orientation ist optional. Der Wert gibt an, wie oft das Kachelbild gegen den Uhrzeigersinn gedreht werden soll. 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.
Wenn Sie einen orientation-Wert angeben, wird das Kachelkoordinatenraster nicht gedreht. Wenn Sie beispielsweise orientation auf 90 setzen, wird durch die x-Koordinate weiterhin die Rechtsrichtung der Kachel definiert, also von Norden nach Süden auf der Karte.
| Null-Grad-Ausrichtung | 90-Grad-Ausrichtung |
|---|---|
Beispiel für eine Kachelanforderung
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 und 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 in eine lokale Datei mit den folgenden Statistiken 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 Prefetch, Caching oder Speicherung von Inhalten.