Kafelki mapy drogowej to kafelki obrazów powstałe na podstawie topograficznych danych wektorowych o stylu kartograficznym Google. Obejmuje to drogi, budynki, ciekawe miejsca i granice polityczne.
Pobieram fragmenty planu
Prośby o kafelki z planem rozwoju możesz wysyłać, gdy otrzymasz token sesji. Token sesji ma zastosowanie do całej sesji, więc nie musisz określać opcji mapy w żądaniach kafelków.
Poniższy przykładowy kod ilustruje typowe żądanie tokena sesji dla fragmentów mapy na drodze.
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 planu możesz uzyskać, wysyłając żądanie HTTPS GET, jak 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 oznacza poziom powiększenia (od 0 do 22), a x i y to współrzędne kafelka, który 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 oraz jest obsługiwana w przypadku żądań zdjęć satelitarnych i żądań terenu, przy czym zdjęcia podstawowe są usuwane za pomocą metody "overlay": true i zestawu layerTypes. Prawidłowe wartości orientation to 0 (wartość domyślna), 90, 180 i 270.
Siatka współrzędnych kafelków nie będzie obrócona, jeśli dodasz wartość orientation. Jeśli np. ustawisz orientation na 90, współrzędna x nadal określa położenie kafelka od lewej do prawej, czyli w tym przypadku z północy na południe na mapie.
| Orientacja 0 stopni | Orientacja 90 stopni |
|---|---|
 |
 |
Przykładowe żądanie kafelka
Przeanalizujmy przykład poniżej, który wymaga pojedynczego kafelka zawierającego cały świat. W tym przykładzie poziom powiększenia wynosi 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 nie znaleziono komunikatu odpowiedzi z serwera. Zamiast tego kafelek zostanie pobrany do pliku lokalnego z poniższymi 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 odpowiedzi znajdziesz w artykule na temat wstępnego pobierania, buforowania lub przechowywania treści.