Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Sitzungstokens mit der Map Tiles API verwenden

Entwickler im Europäischen Wirtschaftsraum (EWR)

Ein Sitzungstoken ist ein Datenelement (eine UUID), das in REST-Aufrufen verwendet wird, um eine Sitzung zu identifizieren, also eine Reihe von zusammengehörigen Nachrichtenaustauschen. Sie müssen in allen Anfragen für 2D-Kacheln und Street View-Bilder ein Sitzungstoken angeben. Sie fügen ihn als Wert eines session-Parameters ein, der an alle Anfrage-URLs angehängt wird.

In der Map Tiles API steht ein Sitzungstoken für eine definierte Gruppe von Anzeigeoptionen. Das bedeutet, dass Sie nicht bei jeder Kachelanfrage eine Reihe von Anzeigeoptionen übergeben müssen. Sie können dasselbe Sitzungstoken für mehrere Clients verwenden. Ein Sitzungstoken ist derzeit zwei Wochen ab dem Ausstellungszeitpunkt gültig. Dies kann sich jedoch ändern. Sie können die Ablaufzeit eines Sitzungstokens jederzeit im Feld expiry der Antwortnachricht einsehen.

Sitzungstokenanfrage

Wenn Sie ein Sitzungstoken anfordern möchten, senden Sie eine HTTPS-POST-Anfrage an den Endpunkt createSession, wie im folgenden Beispiel gezeigt. Sie müssen die Anfrage mit einem Content-Type: application/json-Header senden.

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Pflichtfelder

mapType

Der Typ der Basiskarte. Folgende Werte sind möglich:

roadmap: Die standardmäßigen Google Maps-Kartenkacheln.
satellite: Satellitenbilder
terrain: Geländebilder. Wenn Sie terrain als Kartentyp auswählen, müssen Sie auch den Ebenentyp layerRoadmap angeben (siehe Abschnitt Optionale Felder).
streetview: Street View-Panoramen. Weitere Informationen finden Sie unter Street View-Kacheln.

language

Ein IETF-Sprach-Tag, das die Sprache angibt, in der Informationen auf den Kacheln angezeigt werden. en-US gibt beispielsweise die englische Sprache an, wie sie in den USA gesprochen wird.

region

Eine Regionskennung des Common Locale Data Repository (zwei Großbuchstaben), die den physischen Standort des Nutzers darstellt. Beispiel: US.

Optionale Felder

imageFormat

Gibt das Dateiformat an, das zurückgegeben werden soll. Gültige Werte sind entweder jpeg oder png. JPEG-Dateien unterstützen keine Transparenz und werden daher nicht für Overlay-Kacheln empfohlen. Wenn Sie kein imageFormat angeben, wird automatisch das beste Format für die Tile ausgewählt.

scale

Die Größe von Kartenelementen (z. B. Straßenlabels) wird vergrößert, während die Kachelgröße und der Abdeckungsbereich der Standardkachel beibehalten werden. Wenn Sie den Maßstab erhöhen, werden auch weniger Labels auf der Karte angezeigt, was die Übersichtlichkeit verbessert. Die folgenden Werte sind gültige scale-Werte:

scaleFactor1x: Der Standardwert.
scaleFactor2x: Verdoppelt die Labelgröße und entfernt Labels für kleinere Elemente.
scaleFactor4x: Vervierfacht die Labelgröße und entfernt Labels für kleinere Elemente.

Die folgenden Beispiele zeigen die Auswirkungen der Skalierung von Kartenelementen.

Skalierungsfaktor 1x	Skalierungsfaktor 2x

highDpi: Gibt an, ob hochauflösende Kacheln zurückgegeben werden sollen. Wenn der Skalierungsfaktor erhöht wird, wird highDpi verwendet, um die Größe der Kachel zu erhöhen. Normalerweise wird durch Erhöhen des Skalierungsfaktors die resultierende Kachel zu einem Bild derselben Größe vergrößert, was die Qualität verringert. Bei highDpi wird auch die resultierende Größe erhöht, wobei die Qualität erhalten bleibt. DPI steht für „Dots per Inch“ (Punkte pro Zoll). „Hohe DPI“ bedeutet, dass die Kachel mit mehr Punkten pro Zoll als normal gerendert wird. Wenn true, wird die Anzahl der Pixel in den x- und y-Dimensionen mit dem Skalierungsfaktor multipliziert (also 2x oder 4x). Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit scale-Werten von 2x oder 4x. Sie hat keine Auswirkungen auf Kacheln mit 1-facher Skalierung.

Skalierungsfaktor 1x	Skalierungsfaktor 2x High DPI

layerTypes

Ein Array von Werten, das die der Karte hinzugefügten Ebenentypen angibt. Gültige Werte sind:

layerRoadmap: Erforderlich, wenn Sie terrain als Kartentyp angeben. Kann optional auch über den Kartentyp satellite gelegt werden. Hat keine Auswirkungen auf Roadmap-Kacheln.
layerStreetview: Zeigt Straßen und Orte mit Street View-Aufnahmen mit blauen Umrissen auf der Karte an.
layerTraffic: Zeigt die aktuelle Verkehrslage an.

styles

Ein Array von JSON-Stilobjekten, die das Erscheinungsbild und den Detaillierungsgrad von Kartenelementen wie Straßen, Parks und bebauten Gebieten festlegen. Mit Stilen können Sie die Standardbasiskarte von Google anpassen. Der Parameter styles ist nur gültig, wenn der Kartentyp roadmap ist. Die vollständige Stilsyntax finden Sie in der Stilreferenz.

overlay

Ein boolescher Wert, der angibt, ob layerTypes als separates Overlay gerendert oder mit den Basisbildern kombiniert werden soll. Wenn true, wird die Basiskarte nicht angezeigt. Wenn Sie keine layerTypes definiert haben, wird dieser Wert ignoriert.

Wenn Sie beispielsweise den Kartentyp satellite mit der Ebene layerRoadmap und overlay auf false festgelegt anfordern, erhalten Sie Kacheln, die dem Kartentyp hybrid in der Maps JavaScript API entsprechen (linkes Bild). Wenn Sie dieselben Karten- und Ebenentypen mit overlay auf true festlegen, erhalten Sie eine transparente Kachel mit einem Karten-Overlay, das für die Überlagerung von Satellitenbildern geeignet ist (rechtes Bild).

`overlay`: false	`overlay`: true

Der folgende JSON-Code ist ein Beispiel für einen typischen Anfragetext, der sowohl erforderliche als auch optionale Felder enthält.

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

In diesem Beispiel wird ein Overlay bereitgestellt, das sich für die Kombination mit Satellitenbildern eignet. Das Beispiel enthält sowohl eine Straßenkarte als auch ein Street View-Overlay. Die resultierende Karte wird mit Namen und Daten in der englischen Sprache gerendert, wie sie in den USA gesprochen wird.

Sitzungstoken-Antwort

Der folgende JSON-Code ist ein Beispiel für einen Antworttext.

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

Die folgende Liste enthält Definitionen der Felder im Antworttext.

session: Ein Sitzungstokenwert, den Sie in alle Map Tiles API-Anfragen einfügen müssen.
expiry: Ein String, der die Zeit (in Sekunden seit der UNIX-Epoche) enthält, zu der das Token abläuft. Ein Sitzungstoken ist ab dem Erstellungszeitpunkt zwei Wochen lang gültig. Diese Richtlinie kann sich jedoch ohne Vorankündigung ändern.
tileWidth: Die Breite der Kacheln in Pixeln.
tileHeight: Die Höhe der Kacheln in Pixeln.
imageFormat: Das Bildformat, das entweder png oder jpeg sein kann.