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. W przypadku żądań dotyczących obrazów 2D i zdjęć Street View musisz dołączyć token sesji. Dołączasz go jako wartość parametru session dołączonego do wszystkich adresów URL żądań.

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 w różnych klientach. 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 elementy mapy w Mapach 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. Te wartości są prawidłowe: scale:

• scaleFactor1x: wartość domyślna.
• scaleFactor2x: zwiększa rozmiar etykiety i usuwa drobne etykiety cech.
• scaleFactor4x: czterokrotnie zwiększa rozmiar etykiety i usuwa etykiety funkcji drugorzędnych.

Poniższe przykłady pokazują efekt skalowania elementów mapy.

Współczynnik skali 1x	Współczynnik skalowania 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ż 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 parametr 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. Nie ma to wpływu na kafelki w skali 1 x.

Współczynnik skalowania 1 x	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 wybierzesz 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 dostępne w Street View za pomocą niebieskich obrysów na mapie.

layerTraffic

Pokazuje aktualne warunki na drogach.

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 layerTypes ma być renderowany jako osobna nakładka, czy połączony z obrazem podstawowym. Gdy 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 i wartością overlay ustawioną na false powoduje, że kafelki są równoważne z typem mapy hybrid używanym w Maps JavaScript API (zdjęcie po lewej). 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 pokazuje nakładkę, która nadaje się do połączenia z obrazem satelitarnym. 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 zawierający czas (w sekundach od początku epoki), w którym token wygasa. Token sesji jest ważny przez 2 tygodnie od momentu jego utworzenia, ale te zasady mogą 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.