Ein Sitzungstoken ist ein Datenelement (eine UUID), das in REST-Aufrufen zur Identifizierung einer Sitzung – einer Reihe zusammengehöriger Nachrichtenaustausche – verwendet wird. Bei allen Anfragen für 2D-Kacheln und Street View-Bilder müssen Sie ein Sitzungstoken angeben.
Sie schließen ihn als Wert des Parameters session
ein, der an alle Anfrage-URLs angehängt wird.
In der Map Tiles API stellt ein Sitzungstoken einen definierten Satz von Anzeigeoptionen dar. Das bedeutet, dass Sie nicht bei jeder Kachelanfrage einen Satz von Anzeigeoptionen übergeben müssen. Sie können dasselbe Sitzungstoken für mehrere Clients verwenden.
Ein Sitzungstoken ist ab dem Zeitpunkt der Ausstellung zwei Wochen lang gültig. Dies kann sich jedoch ändern. Sie können die Ablaufzeit eines Sitzungstokens jederzeit im Feld expiry
der Antwortnachricht prüfen.
Sitzungstoken-Anfrage
Zum Anfordern eines Sitzungstokens senden Sie eine HTTPS-POST-Anfrage an den Endpunkt createSession
, 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 standardmäßigen gemalten Kartenkacheln von Google Maps
satellite
- Satellitenbilder
terrain
- Geländebilder Wenn Sie
terrain
als Kartentyp auswählen, müssen Sie auch den EbenentyplayerRoadmap
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. Mit
en-US
wird beispielsweise die in den USA gesprochene englische Sprache angegeben.region
Die Regionskennung für die Region Common Locale Data Repository (zwei Großbuchstaben), 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
undpng
. JPEG-Dateien unterstützen keine Transparenz und werden daher für Overlay-Kacheln nicht empfohlen. Wenn Sie keinenimageFormat
angeben, wird automatisch das beste Format für die Kachel ausgewählt. scale
Skaliert die Größe von Kartenelementen (z. B. Straßenlabels) unter Beibehaltung der Kachelgröße und des Abdeckungsbereichs der Standardkachel. Durch das Vergrößern des Maßstabs 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
: Die Labelgröße wird verdoppelt und Labels für kleinere Elemente werden entfernt.scaleFactor4x
: Vervierfacht die Labelgröße und entfernt Labels kleinerer Elemente.
Die folgenden Beispiele zeigen die Auswirkungen der Skalierung von Kartenelementen.
Skalenfaktor 1x | 2-facher Skalierungsfaktor |
---|---|
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 auf ein Bild derselben Größe vergrößert, was die Qualität verschlechtert. MithighDpi
wird die resultierende Größe ebenfalls erhöht, um die Qualität zu erhalten. DPI steht für Dots per Inch und High DPI bedeutet, dass die Kachel mit mehr Punkten pro Zoll als normal gerendert wird. Beitrue
wird die Anzahl der Pixel in jeder x- und y-Dimension mit dem Skalierungsfaktor (2x oder 4x) multipliziert. Der Abdeckungsbereich der Kachel bleibt unverändert. Dieser Parameter funktioniert nur mit denscale
-Werten 2x oder 4x. Sie hat keine Auswirkungen auf Kacheln mit 1x-Skala.
Skalenfaktor 1x | 2-facher Skalierungsfaktor für High DPI |
---|---|
layerTypes
Ein Array von Werten, das die Ebenentypen angibt, die der Karte hinzugefügt wurden. Gültige Werte sind:
layerRoadmap
- Erforderlich, wenn Sie
terrain
als Kartentyp angeben. Kann auch optional über den Kartentypsatellite
gelegt werden. Hat keine Auswirkungen auf Straßenkartenkacheln. layerStreetview
- Street View-fähige Straßen und Orte werden auf der Karte mit blauen Umrissen dargestellt.
layerTraffic
- Zeigt die aktuelle Verkehrslage an.
styles
Ein Array von JSON-Stilobjekten, mit denen die Darstellung und Detailebene von Kartenelementen wie Straßen, Parks und bebauten Flächen festgelegt werden. Mithilfe von Stilen wird die Standard-Basiskarte von Google angepasst. Der Parameter
styles
ist nur gültig, wenn der Kartentyproadmap
ist. Die vollständige Stilsyntax finden Sie in der Stilreferenz.overlay
Ein boolescher Wert, der angibt, ob
layerTypes
als separates Overlay oder kombiniert mit den Basisbildern gerendert werden soll. Beitrue
wird die Basiskarte nicht angezeigt. Wenn Sie keinelayerTypes
definiert haben, wird dieser Wert ignoriert.
Wenn Sie beispielsweise den Kartentyp satellite
mit einer layerRoadmap
-Ebene und overlay
auf false
anfordern, erhalten Sie Kacheln, die dem Kartentyp hybrid
entsprechen, der in der Maps JavaScript API verwendet wird (linkes Bild). Dieselben Karten- und Ebenentypen, bei denen overlay
auf true
gesetzt ist, führt zu einer transparenten Kachel mit einem Karten-Overlay, das entsprechend formatiert ist für Overlays über Satellitenbilder (rechtes Bild).
overlay : falsch |
overlay : wahr |
---|---|
Die folgende JSON-Datei 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 eine Straßenkarte 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 Optionen angeben, die angewendet werden können.
Unterstützte Optionen sind:
MCYJ5E517XR2JC
: Damit aktivieren Sie den neuen Kartenstil. Während des Aktivierungszeitraums erhalten Ihre Anfragen den vorhandenen Stil, sofern Sie diesen Wert nicht angeben.
Antwort mit Sitzungstoken
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 Sitzungstokenwert, den Sie in allen Map Tiles API-Anfragen angeben müssen.
expiry
- Ein String, der die Zeit (in Sekunden seit Epoche) enthält, zu der das Token abläuft. Ein Sitzungstoken ist ab Erstellung zwei Wochen lang gültig. Diese Richtlinie kann jedoch ohne vorherige Ankündigung geändert werden.
tileWidth
- Die Breite der Kacheln in Pixeln.
tileHeight
- Die Höhe der Kacheln in Pixeln.
imageFormat
- Das Bildformat, entweder
png
oderjpeg
.