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 – eine Reihe zusammengehöriger Nachrichtenaustausche. Sie müssen in allen Anfragen für 2D-Kacheln und Street View-Bilder ein Sitzungstoken angeben. Fügen Sie es als Wert eines session-Parameters an alle Anfrage-URLs an.

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

Anfrage für Sitzungstoken

Senden Sie eine HTTPS-POST-Anfrage an den Endpunkt createSession, um ein Sitzungstoken anzufordern, 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 Standard-Google Maps-Kartenkacheln.
satellite: Satellitenbilder.
terrain: Geländebilder. Wenn Sie terrain als Kartentyp auswählen, müssen Sie auch den Layer-Typ 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. en-US gibt beispielsweise die englische Sprache an, wie sie in den Vereinigten Staaten gesprochen wird.

region

Eine Regions-ID aus dem Common Locale Data Repository (zwei Großbuchstaben), die den physischen Standort des Nutzers darstellt. Beispiel: US.

Optionale Felder

imageFormat

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

scale

Vergrößert die Größe von Kartenelementen (z. B. Straßenlabels), während 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: Die Standardeinstellung.
scaleFactor2x: Verdoppelt die Labelgröße und entfernt Labels für kleinere Features.
scaleFactor4x: Vervierfacht die Labelgröße und entfernt Labels für kleinere Features.

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 beim 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 (Punkte pro Zoll). „High DPI“ bedeutet, dass die Kachel mit mehr Punkten pro Zoll als normal gerendert wird. Wenn true, wird die Anzahl der Pixel in jeder der x- und y-Dimensionen mit dem Skalierungsfaktor multipliziert (d. h. 2x oder 4x). Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit scale-Werten von 2x oder 4x. Er hat keine Auswirkungen auf Kacheln mit dem Skalierungsfaktor 1x.

Skalierungsfaktor 1x	Skalierungsfaktor 2x High DPI

layerTypes

Ein Array von Werten, das die Layer-Typen 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 gelegt werden. Hat keine Auswirkungen auf Straßenkartenkacheln.
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 die Detailgenauigkeit von Kartenmerkmalen wie Straßen, Parks und bebauten Gebieten angeben. Mit Stilen lässt sich die Standard-Basiskarte 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 Basiskarten kombiniert 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 einem layerRoadmap-Layer anfordern und overlay auf false setzen, erhalten Sie Kacheln, die dem in der Maps JavaScript API verwendeten Kartentyp hybrid entsprechen (linkes Bild). Bei denselben Karten- und Layer-Typen mit overlay auf true erhalten Sie eine transparente Kachel mit einem Karten-Overlay, das für das Überlagern von Satellitenbildern formatiert ist (rechtes Bild).

`overlay`: false	`overlay`: true

Das folgende JSON ist ein Beispiel für einen typischen Anfragetext, der sowohl Pflichtfelder 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 enthält ein Overlay, das sich für die Kombination mit Satellitenbildern eignet. 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 Vereinigten Staaten gesprochen wird.

Antwort für Sitzungstoken

Das folgende JSON 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 Anfragen an die Map Tiles API 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 zwei Wochen ab dem Erstellungsdatum 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.