Kafelki z planem trasy

Omówienie kafelka mapyPłytki mapy drogowej to płytki obrazów oparte na wektorowych danych topograficznych ze stylem kartograficznym Google. Obejmuje to drogi, budynki, punkty zainteresowania i granice polityczne.

Pobieranie kafelków z harmonogramem rozwoju

Gdy otrzymasz token sesji, możesz zacząć wysyłać żądania kafelków mapy drogowej. Ponieważ token sesji ma zastosowanie do całej sesji, nie musisz określać opcji mapy w żądaniach dotyczących kafelków.

Poniższy przykładowy kod pokazuje typowe żądanie tokena sesji dotyczące kafelków roadmap.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Kafelki mapy można wyświetlić, wysyłając żądanie HTTPS GET, jak pokazano w poniższym przykładzie.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

W tym żądaniu HTTPS GET z to poziom powiększenia (od 0 do 22), a xy to współrzędne płytki, którą chcesz pobrać.

Parametr orientation jest opcjonalny. Jej wartość określa liczbę stopni obrotu obrazu kafelka w lewo. Funkcja orientation jest obsługiwana w przypadku kafelków roadmap. Jest również obsługiwana w przypadku żądań zdjęć satelitarnych i terenowych, których zdjęcia podstawowe zostały usunięte za pomocą funkcji "overlay": true i z ustawionym layerTypes. Prawidłowe wartości orientation to 0 (domyślna), 90, 180 i 270.

Jeśli uwzględnisz wartość orientation, siatka współrzędnych płytek nie zostanie obrócona. Jeśli np. ustawisz wartość orientation na 90, współrzędna x nadal określa położenie kafelka od lewej do prawej, czyli w tym przypadku od północy na południe na mapie.

Orientacja w poziomie Orientacja o 90 stopni
Orientacja w poziomie Orientacja o 90 stopni

Przykładowe żądanie pliku

Rozważ ten przykład, w którym wysyłane jest żądanie dotyczące pojedynczej płytki obejmującej cały świat. W tym przykładzie poziom powiększenia wynosi 0, a współrzędne X i Y – 0, 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

W tym przykładzie serwer nie wysyła żadnej odpowiedzi. Zamiast tego kafelek zostanie pobrany do pliku lokalnego z tymi statystykami.

Cały świat w jednym kafelku

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

Informacje o nagłówkach wiadomości z odpowiedzią znajdziesz w artykule Pobieranie wstępne, buforowanie lub przechowywanie treści.