Sitzungstokens mit der Map Tiles API verwenden

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

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

Hinweis :Sie müssen Sitzungstokens verwenden, um 2D- und Street View-Kacheln abzurufen, nicht jedoch, um 3D-Kacheln abzurufen.

Sitzungstokenanfrage

Wenn du ein Sitzungstoken anfordern möchtest, sende eine HTTPS-POST-Anfrage an den createSession-Endpunkt, 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 Region-ID (zwei Großbuchstaben) des Common Locale Data Repository, 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 oder png. JPEG-Dateien unterstützen keine Transparenz und werden daher für Overlay-Kacheln nicht empfohlen. Wenn Sie kein imageFormat angeben, wird das beste Format für die Kachel automatisch 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. Durch die Erhöhung des Maßstabs wird auch die Anzahl der Beschriftungen auf der Karte reduziert, was für mehr Übersichtlichkeit sorgt. Die folgenden Werte sind gültige scale-Werte:

• scaleFactor1x: Der Standardwert.
• scaleFactor2x: Die Labelgröße wird verdoppelt und Labels für untergeordnete Elemente werden entfernt.
• scaleFactor4x: Die Labelgröße wird vervierfacht und Labels für untergeordnete Elemente werden entfernt.

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 die resultierende Kachel durch Erhöhen des Skalierungsfaktors auf ein Bild derselben Größe vergrößert, was die Qualität verringert. Bei highDpi wird auch die resultierende Größe erhöht, um die Qualität beizubehalten. DPI steht für „Dots Per Inch“ (Punkte pro Zoll). „High DPI“ bedeutet, dass die Kachel mit mehr Punkten pro Zoll gerendert wird als normal. Wenn true, wird die Anzahl der Pixel in den X- und Y-Dimensionen jeweils mit dem Skalierungsfaktor multipliziert (d. h. 2- oder 4-fach). Das Abdeckungsgebiet der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit scale-Werten von 2 oder 4. Auf Kacheln mit einer Skalierung von 1:1 hat sie keine Auswirkungen.

Skalierungsfaktor: 1x	Skalierungsfaktor 2x High DPI

layerTypes

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

layerRoadmap

Erforderlich, wenn Sie terrain als Kartentyp angeben. Kann optional auch auf den Kartentyp satellite überlagert werden. Hat keine Auswirkungen auf die Kacheln der Roadmap.

layerStreetview

Straßen und Orte mit Street View-Aufnahmen sind auf der Karte blau umrandet.

layerTraffic

Die aktuelle Verkehrslage.

styles

Ein Array von JSON-Objekten, das das Aussehen und die Detailebene von Kartenelementen wie Straßen, Parks und bebauten Gebieten angibt. Mithilfe von Stilen können Sie die Standard-Google-Basiskarte anpassen. Der Parameter styles ist nur gültig, wenn der Kartentyp roadmap ist. Die vollständige Syntax für Stile finden Sie in der Referenz zu Stilen.

overlay

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

Wenn Sie beispielsweise einen satellite-Kartentyp mit einer layerRoadmap-Ebene anfordern und overlay auf false festgelegt ist, werden Kacheln ausgegeben, die dem in der Maps JavaScript API verwendeten hybrid-Kartentyp entsprechen (linkes Bild). Dieselben Karten- und Ebenentypen mit overlay auf true führen zu einer transparenten Kachel mit einem Karten-Overlay, das für die Überlagerung von Satellitenbildern geeignet ist (rechtes Bild).

overlay: false	overlay: true

Das folgende JSON-Objekt 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" }
      ]
    }
  ]
}

Dieses Beispiel zeigt ein Overlay, 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 englischer Sprache gerendert, wie sie in den USA gesprochen wird.

apiOptions: Ein Array von Werten, die zusätzliche Optionen angeben. Unterstützte Optionen sind:

• MCYJ5E517XR2JC: Sie können den neuen Kartenstil aktivieren. Während der Aktivierungsphase wird für Ihre Anfragen der vorhandene Stil verwendet, sofern dieser Wert nicht angegeben wird.

Antwort mit Sitzungstoken

Das folgende JSON-Objekt ist ein Beispiel für den Antworttext.

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

In der folgenden Liste sind die Felder im Antworttext definiert.

session

Ein Sitzungstoken, das Sie in allen Map Tiles API-Anfragen angeben müssen.

expiry

Ein String, der die Zeit in Sekunden seit der Epoche enthält, zu der das Token abläuft. Ein Sitzungstoken ist ab dem Zeitpunkt der Erstellung zwei Wochen lang gültig. Diese Richtlinie kann sich jedoch ohne vorherige Ankü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.