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.