Używanie tokenów sesji z interfejsem Map Tiles API

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ą.

Uwaga: aby uzyskać kafelki 2D i kafelki Street View, musisz użyć tokenów sesji. ale nie w przypadku kafelków 3D.

Żą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 warstwy layerRoadmap (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 lub png. Pliki JPEG nie obsługują przezroczystości, więc nie są zalecane w przypadku: kafelki nakładane. Jeśli nie określisz wartości imageFormat, 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 funkcji highDpi rozmiar wynikowy jest również ich poprawa przy utrzymaniu ich jakości. 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 true, 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 mapy satellite. 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 to roadmap. 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. Kiedy true, mapa podstawowa nie jest wyświetlana. Jeśli nie masz zdefiniowanych żadnych layerTypes, , 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 lub jpeg.