Płytki mapy drogowej to płytki obrazów oparte na wektorowych danych topograficznych ze stylizacją kartograficzną Google. Obejmuje to drogi, budynki, punkty zainteresowania i granice polityczne.
Pobieram fragmenty mapy
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"
Płytki mapy drogowej można uzyskać, wysyłając żądanie HTTPS GET, jak pokazano w tym 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) oraz x
i
y
to
współrzędne kafelka
kafelka, który chcesz pobrać.
Parametr orientation
jest opcjonalny. Jego wartość określa liczbę stopni obrotu obrazu kafelka w kierunku przeciwnym do ruchu wskazówek zegara. orientation
jest obsługiwana w przypadku elementów roadmap
, a także w przypadku żądań dotyczących zdjęć satelitarnych i terenu z usuniętymi zdjęciami bazowymi za pomocą parametru "overlay": true
i z ustawionym parametrem layerTypes
. Prawidłowe wartości orientation
to 0 (wartość 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, to współrzędna x
nadal określa położenie kafelka od lewej do prawej, które w tym przypadku jest od północy do południa na mapie.
Orientacja 0 stopni | Orientacja 90 stopni |
---|---|
Przykładowe żądanie kafelka
Weźmy pod uwagę przykład, który wymaga pojedynczego kafelka zawierającego na całym świecie. W tym przykładzie poziom powiększenia wynosi 0, a współrzędne x i y są 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 jako plik lokalny z tymi statystykami.
% 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 odpowiedziami znajdziesz w sekcji Wstępne pobieranie, buforowanie lub przechowywanie treści.