Sitzungstokens mit der Map Tiles API verwenden

Ein Sitzungstoken ist ein Datenelement (eine UUID) der in REST-Aufrufen verwendet wird, um ein session (Sitzung): ein verwandten Nachrichtenaustauschs. Sie müssen in allen 2D-Kacheln und Street View-Bilder angefordert. 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 zwei Wochen lang Problematik verursacht, aber das kann sich ändern. Sie können die Ablaufzeit eines Sitzungstoken anhand des Felds expiry in der Antwortnachricht.

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

A Gemeinsames Gebietsschema-Daten-Repository Regionskennung (zwei Großbuchstaben), die den physischen Standort darstellt der Nutzenden. 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 Kacheln mit hoher Auflösung 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, dann Die Anzahl der Pixel in jeder der x- und y-Dimensionen wird mit der Skala multipliziert. , also 2x oder 4x. Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit scale-Werten, die 2x oder 4x betragen. 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

Boolescher Wert, der angibt, ob layerTypes als separates Overlay oder in Kombination mit dem Basisbild gerendert. 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

Die folgende JSON-Datei ist ein Beispiel für einen typischen Anfragetext, der sowohl Pflichtfelder und optionale Felder.

{
  "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 des Aktivierungszeitraums erhalten Ihre Anfragen die vorhandenen Stil, es sei denn, dieser Wert ist angegeben.

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 Erstellung zwei Wochen lang gültig. aber diese Richtlinie kann ohne Vorankü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.