Sitzungstokens mit der Map Tiles API verwenden

Ein Sitzungstoken ist ein Datenelement (eine UUID) der in REST-Aufrufen verwendet wird, um ein session (Sitzung): verwandten Nachrichtenaustauschs. 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 Anfragen angehängt wird. URLs.

In der Map Tiles API stellt ein Sitzungstoken einen definierten Satz von Anzeigeoptionen. Sie müssen also keine Anzeigeoptionen für jede Kachelanforderung. 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.

Sitzungstoken-Anfrage

Senden Sie eine HTTPS-POST-Anfrage an createSession, um ein Sitzungstoken anzufordern wie im folgenden Beispiel gezeigt. Sie müssen die Anfrage mit einer Content-Type: application/json-Header.

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 Binden Sie den Ebenentyp layerRoadmap ein (siehe Beschreibung in der Optionale Felder Abschnitt).
streetview
Street View-Panoramen Weitere Informationen finden Sie unter Street View-Kacheln:
language

Eine IETF-Sprach-Tag gibt die Sprache an, in der die Informationen auf den Kacheln angezeigt werden. Für Mit en-US wird beispielsweise die in den USA gesprochene englische Sprache angegeben.

region

Eine Region-ID (zwei Großbuchstaben) aus dem 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 nicht empfohlen für Overlay-Kacheln Wenn Sie kein imageFormat angeben, wird das beste Format für wird die Kachel automatisch ausgewählt.
scale

Verkleinert die Größe von Kartenelementen (wie Straßenbezeichnungen) unter Beibehaltung des Kachelgröße und Abdeckungsbereich der Standardkachel. Das Erhöhen der Reichweite reduziert die Anzahl der Labels auf der Karte und sorgt für mehr Ordnung. 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
Karte mit Skalierungsfaktor 1x Karte mit Skalierungsfaktor 2x
highDpi
Gibt an, ob hochauflösende Kacheln zurückgegeben werden sollen. Wenn der Skalierungsfaktor erhöht, wird highDpi verwendet, um die Größe der Kachel zu erhöhen. Normalerweise Durch Erhöhen des Skalierungsfaktors wird die resultierende Kachel zu einem Bild des die gleiche Größe haben, was die Qualität verschlechtert. Bei highDpi ist die resultierende Größe ebenfalls und die Qualität erhalten bleiben. DPI steht für Dots per Inch, und hohe DPI bedeutet, Die Kachel wird mit mehr Punkten pro Zoll als normal gerendert. Wenn true, wird die Anzahl der Pixel in den X- und Y-Dimensionen jeweils mit dem Skalierungsfaktor multipliziert (d. h. 2- oder 4-fach). Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit scale-Werten von 2x oder 4x. Dies hat keine Auswirkungen auf 1x maßstabsgetreue Kacheln.
Faktor 1x Faktor für Skala: 2x hohe DPI
Karte in normaler Auflösung Karte wird mit 2-fach hoher DPI-Auflösung angezeigt
layerTypes

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

layerRoadmap
Erforderlich, wenn Sie als Kartentyp terrain angeben. Kann auch optional sein als Overlay mit dem Kartentyp satellite. Hat keine Auswirkungen auf Straßenkartenkacheln.
layerStreetview
Street View-aktivierte Straßen und Orte werden auf der Karte.
layerTraffic
Zeigt die aktuelle Verkehrslage an.
styles

Ein Array von JSON-Stilobjekten, die die Darstellung und Detailebene eines wie Straßen, Parks und bebaute Flächen. Mit der Gestaltung die Standard-Basiskarte von Google anpassen. Der Parameter styles ist nur gültig, wenn ist der Kartentyp roadmap. Die vollständige Stilsyntax finden Sie in der Stilreferenz:

overlay

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

Wenn Sie beispielsweise einen satellite-Kartentyp mit einer layerRoadmap-Ebene anfordern, und Wenn overlay auf false festgelegt ist, erhalten Sie Kacheln, die dem Kartentyp hybrid entsprechen. die in der Maps JavaScript API verwendet werden (linkes Bild). Das Gleiche Karten- und Ebenentypen, bei denen 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
Overlay auf „false“ gesetzt Overlay auf "true" gesetzt

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" }
      ]
    }
  ]
}

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

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

  • MCYJ5E517XR2JC – Aktiviere die neue Karte . Während der Aktivierungsphase wird für Ihre Anfragen der vorhandene Stil verwendet, sofern dieser Wert nicht angegeben wird.

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 alle Ihre Map Tiles API aufnehmen müssen
expiry
Ein String, der den Zeitpunkt (in Sekunden seit der Epoche) enthält, zu dem das Token ausgeführt wird. verfällt. 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, gemessen in Pixeln.
tileHeight
Die Höhe der Kacheln, gemessen in Pixeln
imageFormat
Das Bildformat, entweder png oder jpeg.