Straßenkartenkacheln

Entwickler im Europäischen Wirtschaftsraum (EWR)

Übersicht über die Kachel „Roadmap“Straßenkartenkacheln 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

Sie können mit dem Senden von 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 mit Ihren Kachelanfragen angeben.

Das folgende Codebeispiel zeigt eine typische Anfrage für ein Sitzungstoken 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"

Sie erhalten Straßenkartenkacheln, 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 sind die Kachelkoordinaten der Kachel, die Sie abrufen möchten.

Der Parameter orientation ist optional. Der Wert gibt die Anzahl der Grad an, um die das Kachelbild gegen den Uhrzeigersinn gedreht wird. 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 orientation beispielsweise auf 90 Grad festlegen, wird die Position der Kachel von links nach rechts weiterhin durch die x-Koordinate definiert, in diesem Fall also von Norden nach Süden auf der Karte.

Ausrichtung bei 0 Grad Ausrichtung um 90 Grad
Ausrichtung bei 0 Grad Ausrichtung um 90 Grad

Beispiel für eine Kachelanfrage

Betrachten wir das folgende Beispiel, das eine einzelne Kachel anfordert, 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.

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 Antwortnachrichtenheadern finden Sie unter Inhalte vorab abrufen, zwischenspeichern oder speichern.