Sitzungstokens mit der Map Tiles API verwenden

Ein Sitzungstoken ist ein Datenelement (UUID), das in REST-Aufrufen verwendet wird, um eine Sitzung – eine Reihe verwandter Nachrichtenaustausche – zu identifizieren. Alle Anfragen für 2D-Kacheln und Street View-Bilder müssen ein Sitzungstoken enthalten. 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 einen definierten Satz von Anzeigeoptionen. Das bedeutet, dass Sie nicht mit jeder Kachelanfrage eine Reihe von Anzeigeoptionen übergeben müssen. Sie können dasselbe Sitzungstoken für mehrere Clients verwenden. Ein Sitzungstoken ist derzeit ab dem Zeitpunkt der Ausgabe 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 :Für den Erhalt von 2D- und Street View-Kacheln müssen Sitzungstokens verwendet werden, nicht jedoch für 3D-Kacheln.

Sitzungstoken-Anfrage

Senden Sie eine HTTPS-POST-Anfrage wie im folgenden Beispiel gezeigt an den Endpunkt createSession, um ein Sitzungstoken anzufordern. 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. Dieser wird im Abschnitt Optionale Felder beschrieben.

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. Mit en-US wird beispielsweise die in den USA gesprochene englische Sprache angegeben.

region

Die 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 jpeg oder 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

Die Größe von Kartenelementen (z. B. Straßenlabels) wird vertikal skaliert, wobei die Kachelgröße und der Abdeckungsbereich der Standardkachel beibehalten werden. Wenn Sie den Maßstab erhöhen, 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: Der Standardwert.
• scaleFactor2x: Verdoppelt die Größe der Labels und entfernt Labels von kleineren Elementen.
• scaleFactor4x: Die Labelgröße wird vervierfacht und die Labels kleinerer Elemente werden entfernt.

Die folgenden Beispiele veranschaulichen die Auswirkungen der Skalierung von Kartenelementen.

Faktor 1x	Faktor 2x

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 zu einem Bild derselben Größe vergrößert, was die Qualität verringert. Mit highDpi wird auch die resultierende Größe erhöht, wodurch die Qualität erhalten bleibt. DPI steht für Dots per Inch und ein hoher DPI bedeutet, dass die Kachel mit mehr Punkten pro Zoll als normal gerendert wird. Bei true wird die Anzahl der Pixel in jeder der 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, die 2x oder 4x betragen. Es hat keine Auswirkungen auf Kacheln mit 1-facher Größe.

Faktor 1x	Faktor für Skala: 2x hohe DPI

layerTypes

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

layerRoadmap

Erforderlich, wenn Sie als Kartentyp terrain 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 blau hervorgehoben.

layerTraffic

Zeigt die aktuelle Verkehrslage an.

styles

Ein Array von JSON-Stilobjekten, die die Darstellung und Detailebene von Kartenelementen wie Straßen, Parks und bebauten Flächen angeben. Dabei wird die Standard-Google-Basiskarte 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 in Kombination mit dem Basisbild gerendert werden soll. Wenn 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 gesetzt ist, ergeben sich Kacheln, die dem in der Maps JavaScript API verwendeten hybrid-Kartentyp entsprechen (linkes Bild). Dieselben Karten- und Ebenentypen, für die overlay auf true gesetzt ist, ergeben eine transparente Kachel mit einem Karten-Overlay, das entsprechend gestaltet ist, um es über Satellitenbilder zu überlagern (rechtes Bild).

overlay: falsch	overlay: wahr

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 mit Satellitenbildern kombinieren lässt. Das Beispiel enthält sowohl ein Straßenkarten- 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 anzuwendende Optionen angeben. Unterstützte Optionen sind:

• MCYJ5E517XR2JC: Aktivieren Sie den neuen Kartenstil. Während des Opt-in-Zeitraums wird für Ihre Anfragen der vorhandene Stil verwendet, sofern dieser Wert nicht angegeben ist.

Sitzungstoken-Antwort

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 Sitzungstoken-Wert, den Sie in allen Map Tiles API-Anfragen angeben müssen.

expiry

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

tileWidth

Die Breite der Kacheln, gemessen in Pixeln.

tileHeight

Die Höhe der Kacheln, gemessen in Pixeln

imageFormat

Das Bildformat, entweder png oder jpeg.