Kafelki z planem trasy

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Omówienie kafelka z mapą Kafelki mapy drogowej to kafelki obrazów oparte na wektorowych danych topograficznych z kartograficznym stylem Google. Obejmują one drogi, budynki, punkty zainteresowania i granice polityczne.

Pobieranie kafelków mapy drogowej

Po uzyskaniu tokena sesji możesz zacząć wysyłać żądania kafelków mapy drogowej. Ponieważ token sesji dotyczy całej sesji, nie musisz określać opcji mapy w żądaniach kafelków.

Poniższy przykład kodu pokazuje typowe żądanie tokena sesji dla kafelków mapy drogowej.

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"

Fragmenty mapy drogowej uzyskasz, wysyłając żądanie GET HTTPS, 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), a x i y to współrzędne mapy fragmentu mapy, 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ługiwany w przypadku kafelków roadmap, a także w przypadku żądań zdjęć satelitarnych i terenu z usuniętymi obrazami bazowymi za pomocą parametru "overlay": true oraz z ustawionymi parametrami layerTypes. Prawidłowe wartości parametru orientation to 0 (wartość domyślna), 90, 180 i 270.

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

Orientacja 0 stopni Orientacja 90 stopni
Orientacja 0 stopni Orientacja 90 stopni

Przykładowe żądanie kafelka

Zobacz ten przykład, który wysyła żądanie pojedynczego kafelka zawierającego cały świat. W tym przykładzie poziom powiększenia to 0, a współrzędne x i y to 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 wiadomości z odpowiedzią. Zamiast tego kafelek jest pobierany do pliku lokalnego z tymi statystykami.

Cały świat na 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

Więcej informacji o nagłówkach wiadomości z odpowiedzią znajdziesz w artykule Wstępne pobieranie, buforowanie i przechowywanie treści.