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.

Hinweis :Sie benötigen Sitzungstokens, um 2D- und Street View-Kacheln zu erhalten. aber nicht für 3D-Kacheln.

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

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

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

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.