Token sesji to fragment danych (
UUID)
jest używany w wywołaniach REST do identyfikowania
session – a
powiązanych wymian wiadomości. Musisz umieścić token sesji we wszystkich
żądań dotyczących fragmentów 2D i zdjęć Street View.
Uwzględniasz go jako wartość parametru session
dołączonego do wszystkich żądań
Adresy URL.
W interfejsie Map Tiles API token sesji reprezentuje zdefiniowany zbiór
opcje wyświetlania. Oznacza to, że nie trzeba przesyłać zestawu opcji wyświetlania
każdego kafelka. Możesz używać tego samego tokena sesji na kontach wielu klientów.
Token sesji jest obecnie ważny przez dwa tygodnie od
ale może się to zmienić. Czas wygaśnięcia możesz w każdej chwili sprawdzić
spójrz na pole expiry
w wiadomości z odpowiedzią.
Żądanie tokena sesji
Aby zażądać tokena sesji, wyślij żądanie HTTPS POST do createSession
zgodnie z tym przykładem. Musisz wysłać prośbę z parametrem
Nagłówek Content-Type: application/json
.
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"
Pola wymagane
mapType
Typ mapy podstawowej. Możliwe wartości:
roadmap
- Standardowe malowane fragmenty map Map Google.
satellite
- Zdjęcia satelitarne.
terrain
- Zdjęcia terenu. Wybierając
terrain
jako typ mapy, musisz również uwzględnij typ warstwylayerRoadmap
(opisany w Pola opcjonalne ). streetview
- panoramy Street View. Więcej informacji: Kafelki Street View
language
An Tag języka IETF określające język używany do wyświetlania informacji na kafelkach. Dla: przykładowy atrybut
en-US
określa język angielski używany w Stanach Zjednoczonych.region
O Wspólne repozytorium danych języka identyfikator regionu (2 wielkie litery), który reprezentuje lokalizację fizyczną użytkownika. Na przykład:
US
.
Pola opcjonalne
imageFormat
- Określa format pliku do zwrócenia. Prawidłowe wartości to
jpeg
lubpng
. Pliki JPEG nie obsługują przezroczystości, więc nie są zalecane w przypadku: kafelki nakładane. Jeśli nie określisz wartościimageFormat
, najlepszym formatem będzie kafelek zostanie wybrany automatycznie. scale
Zwiększa rozmiar elementów mapy (takich jak etykiety dróg), zachowując jednocześnie rozmiar i zasięg kafelka domyślnego kafelka. Zwiększanie skali zmniejsza liczbę etykiet na mapie, co sprzyja bałaganowi. Poniżej wartości to prawidłowe wartości atrybutu
scale
:scaleFactor1x
: wartość domyślna.scaleFactor2x
: zwiększa rozmiar etykiety i usuwa drobne etykiety cech.scaleFactor4x
: rozmiar etykiety zwiększa się czterokrotnie i usuwa drobne etykiety cech.
Poniższe przykłady pokazują efekt skalowania elementów mapy.
Współczynnik skali 1x | Współczynnik skali 2x |
---|---|
highDpi
- Określa, czy należy zwrócić kafelki o wysokiej rozdzielczości. Jeśli współczynnik skali to
zwiększono,
highDpi
służy do zwiększania rozmiaru kafelka. Zwykle zwiększenie współczynnika skali powoduje powiększenie wynikowego kafelka do obrazu rozmiaru, co obniża jakość. W przypadku funkcjihighDpi
rozmiar wynikowy jest również a jednocześnie zadbać o ich jakość. DPI oznacza kropki na cal, a High DPI oznacza kafelek jest renderowany przy użyciu większej liczby kropek na cal niż zwykle. Jeśli parametrtrue
, liczba pikseli w każdym z wymiarów x i y jest mnożona przez skalę (czyli 2x lub 4x). Zasięg kafelka pozostaje bez zmian. Ten parametr działa tylko z wartościąscale
równą 2x lub 4x. Funkcja nie działa na Kafelki ze skalą 1x.
Współczynnik skali 1x | Współczynnik skali 2x High DPI |
---|---|
layerTypes
Tablica wartości, która określa typy warstw dodane do mapy. Prawidłowa wartości to:
layerRoadmap
- Wymagane, jeśli jako typ mapy określisz
terrain
. Pole może być też opcjonalne nałożone na typ mapysatellite
. Nie ma wpływu na fragmenty mapy. layerStreetview
- Pokazuje ulice i lokalizacje z obsługą Street View za pomocą niebieskich konturów mapy.
layerTraffic
- Pokazuje aktualne warunki na drodze.
styles
Tablica obiektów stylu JSON, które określają poziom wyglądu i szczegółów obiekty mapy, takie jak drogi, parki i tereny zabudowane. Styl jest używany do: dostosować standardową mapę podstawową Google. Parametr
styles
jest prawidłowy tylko wtedy, gdy typ mapy toroadmap
. Pełną składnię stylu znajdziesz tutaj: Odniesienie do stylu.overlay
Wartość logiczna określająca, czy funkcja
layerTypes
powinna być renderowana jako osobna nakładka lub w połączeniu ze zdjęciem podstawowym. Kiedytrue
, mapa podstawowa nie jest wyświetlana. Jeśli nie masz zdefiniowanych żadnychlayerTypes
, , jest ona ignorowana.
na przykład żądanie typu mapy satellite
z warstwą layerRoadmap
.
Ustawienie overlay
ma wartość false
powoduje wyświetlenie kafelków odpowiadających typowi mapy hybrid
używane w Maps JavaScript API (obraz po lewej stronie). Ta sama
typy map i warstw z atrybutem overlay
ustawionym na true
wyniki na przezroczystym kafelku
z nakładką mapy, dopasowanym do zdjęć satelitarnych
(obraz po prawej stronie).
overlay : fałsz |
overlay : prawda |
---|---|
Poniższy kod JSON to przykład typowej treści żądania, która zawiera zarówno wymaganych i opcjonalnych.
{
"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" }
]
}
]
}
Ten przykład zapewnia nakładkę, która nadaje się do połączenia z satelitą. zdjęcia. Przykład zawiera zarówno plan, jak i nakładkę Street View. jest wyświetlana z nazwami i danymi w języku angielskim, ponieważ używanych w Stanach Zjednoczonych.
apiOptions
: tablica wartości określających dodatkowe opcje do zastosowania.
Obsługiwane opcje:
MCYJ5E517XR2JC
– wyraź zgodę na nowa mapa stylu. W okresie, w którym można dokonywać wyboru, Twoje prośby będą otrzymywać o ile nie określisz tej wartości.
Odpowiedź tokena sesji
Poniższy kod JSON to przykładowa treść odpowiedzi.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
Poniższa lista zawiera definicje pól w treści odpowiedzi.
session
- Wartość tokena sesji, którą musisz uwzględnić w całym interfejsie Map Tiles API żądań.
expiry
- Ciąg tekstowy zawierający czas (w sekundach od początku epoki), w którym token wygasa. Token sesji jest ważny przez 2 tygodnie od jego utworzenia ale mogą one ulec zmianie bez powiadomienia.
tileWidth
- Szerokość kafelków w pikselach.
tileHeight
- Wysokość kafelków mierzona w pikselach.
imageFormat
- Format obrazu, który może mieć wartość
png
lubjpeg
.