Straßenkartenkacheln

Entwickler im Europäischen Wirtschaftsraum (EWR)

Übersicht über die Roadmap-KachelStraßenkarten-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 abrufen

Nachdem 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 bei Ihren Kachelanfragen angeben.

Das folgende Codebeispiel zeigt eine typische Sitzungstokenanfrage für Straßenkarten-Tiles.

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 Straßenkarten-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 (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 der Drehung des Kachelbilds gegen den Uhrzeigersinn an. orientation wird für roadmap-Kacheln unterstützt. Außerdem wird es für Satelliten- und Geländeanfragen unterstützt, 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 festlegen, definiert die Koordinate x weiterhin die Position der Kachel von links nach rechts, was in diesem Fall von Norden nach Süden auf der Karte ist.

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

Beispiel für eine Tile-Anfrage

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

Die ganze Welt in 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 Antwortnachrichten-Headern finden Sie unter Prefetching, Caching oder Speicherung von Inhalten.