Sitzungstokens mit der Map Tiles API verwenden

Ein Sitzungstoken ist ein Datenelement (eine UUID), das in REST-Aufrufen zur Identifizierung einer Sitzung – einer Reihe zusammengehöriger Nachrichtenaustausche – verwendet wird. Bei allen Anfragen für 2D-Kacheln und Street View-Bilder müssen Sie ein Sitzungstoken angeben. Sie schließen ihn als Wert des Parameters session ein, der an alle Anfrage-URLs angehängt wird.

In der Map Tiles API stellt ein Sitzungstoken einen definierten Satz von Anzeigeoptionen dar. Das bedeutet, dass Sie nicht bei jeder Kachelanfrage einen Satz von Anzeigeoptionen übergeben müssen. Sie können dasselbe Sitzungstoken für mehrere Clients verwenden. Ein Sitzungstoken ist ab dem Zeitpunkt der Ausstellung zwei Wochen lang gültig. Dies kann sich jedoch ändern. Sie können die Ablaufzeit eines Sitzungstokens jederzeit im Feld expiry der Antwortnachricht prüfen.

Sitzungstoken-Anfrage

Zum Anfordern eines Sitzungstokens 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 gemalten Kartenkacheln von Google Maps

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-Sprachtag, das die Sprache angibt, in der Informationen auf den Kacheln angezeigt werden. Mit en-US wird beispielsweise die in den USA gesprochene englische Sprache angegeben.

region

Die Regionskennung für die Region Common Locale Data Repository (zwei Großbuchstaben), die den physischen Standort des Nutzers angibt. Beispiel: US.

Optionale Felder

imageFormat

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

scale

Skaliert die Größe von Kartenelementen (z. B. Straßenlabels) unter Beibehaltung der Kachelgröße und des Abdeckungsbereichs der Standardkachel. Durch das Vergrößern des Maßstabs wird auch die Anzahl der Labels auf der Karte reduziert, was für mehr Übersichtlichkeit sorgt. Die folgenden Werte sind gültige scale-Werte:

• scaleFactor1x: Die Standardeinstellung.
• scaleFactor2x: Die Labelgröße wird verdoppelt und Labels für kleinere Elemente werden entfernt.
• scaleFactor4x: Vervierfacht die Labelgröße und entfernt Labels kleinerer Elemente.

Die folgenden Beispiele zeigen die Auswirkungen der Skalierung von Kartenelementen.

Skalenfaktor 1x	2-facher Skalierungsfaktor

highDpi

Gibt an, ob Kacheln mit hoher Auflösung 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 auf ein Bild derselben Größe vergrößert, was die Qualität verschlechtert. Mit highDpi wird die resultierende Größe ebenfalls erhöht, um die Qualität zu erhalten. DPI steht für Dots per Inch und High DPI bedeutet, dass die Kachel mit mehr Punkten pro Zoll als normal gerendert wird. Bei true wird die Anzahl der Pixel in jeder x- und y-Dimension mit dem Skalierungsfaktor (2x oder 4x) multipliziert. Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit den scale-Werten 2x oder 4x. Sie hat keine Auswirkungen auf Kacheln mit 1x-Skala.

Skalenfaktor 1x	2-facher Skalierungsfaktor für High DPI

layerTypes

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

layerRoadmap

Erforderlich, wenn Sie terrain als Kartentyp angeben. Kann auch optional über den Kartentyp satellite gelegt werden. Hat keine Auswirkungen auf Straßenkartenkacheln.

layerStreetview

Street View-fähige Straßen und Orte werden auf der Karte mit blauen Umrissen dargestellt.

layerTraffic

Zeigt die aktuelle Verkehrslage an.

styles

Ein Array von JSON-Stilobjekten, mit denen die Darstellung und Detailebene von Kartenelementen wie Straßen, Parks und bebauten Flächen festgelegt werden. Mithilfe von Stilen wird die Standard-Basiskarte von Google angepasst. 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 oder kombiniert mit den Basisbildern gerendert werden soll. Bei true wird die Basiskarte nicht angezeigt. Wenn Sie keine layerTypes definiert haben, wird dieser Wert ignoriert.

Wenn Sie beispielsweise den Kartentyp satellite mit einer layerRoadmap-Ebene und overlay auf false anfordern, erhalten Sie Kacheln, die dem Kartentyp hybrid entsprechen, der in der Maps JavaScript API verwendet wird (linkes Bild). Dieselben Karten- und Ebenentypen, bei denen overlay auf true gesetzt ist, führt zu einer transparenten Kachel mit einem Karten-Overlay, das entsprechend formatiert ist für Overlays über Satellitenbilder (rechtes Bild).

overlay: falsch	overlay: wahr

Die folgende JSON-Datei 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 mit Satellitenbildern kombinieren lässt. 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.

apiOptions: Ein Array von Werten, die zusätzliche Optionen angeben, die angewendet werden können. Unterstützte Optionen sind:

• MCYJ5E517XR2JC: Damit aktivieren Sie den neuen Kartenstil. Während des Aktivierungszeitraums erhalten Ihre Anfragen den vorhandenen Stil, sofern Sie diesen Wert nicht angeben.

Antwort mit Sitzungstoken

Die folgende JSON-Datei 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 allen Map Tiles API-Anfragen angeben müssen.

expiry

Ein String, der die Zeit (in Sekunden seit Epoche) enthält, zu der das Token abläuft. Ein Sitzungstoken ist ab Erstellung zwei Wochen lang gültig. Diese Richtlinie kann jedoch ohne vorherige Ankündigung geändert werden.

tileWidth

Die Breite der Kacheln in Pixeln.

tileHeight

Die Höhe der Kacheln in Pixeln.

imageFormat

Das Bildformat, entweder png oder jpeg.