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.
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 EbenentyplayerRoadmap
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 Durch
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
oderpng
. JPEG-Dateien unterstützen keine Transparenz und werden daher nicht empfohlen für Overlay-Kacheln Wenn Sie keinimageFormat
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. BeihighDpi
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. Wenntrue
, 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 mitscale
-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 Kartentypsatellite
. 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 Kartentyproadmap
. 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 keinelayerTypes
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
oderjpeg
.