Kafelki mapy to po prostu podział świata na indeksowaną siatkę. Umożliwia wydajny i dynamiczny dostęp do danych map oraz wykorzystanie ich na wielu skalach kartograficznych. Interfejs Map Tiles API zapewnia dostęp do wielu tematycznych geodanych zbiorów danych, w tym do wybranych przez Google:
Fragmenty obrazu mapy na podstawie topograficznych danych wektorowych ze stylem kartograficznym Google.
Ortofotografia wykonywana za pomocą aparatów satelitarnych i powietrznych, które wykonują zdjęcia Ziemi z góry (nadir).
Mapy konturu wzgórza.
Kafelki mapy 2D mają informacje georeferencyjne i są wyrównane względem siebie. Są one wybierane na podstawie geograficznego zakresu widocznego obszaru i poziomu powiększenia. Poziom powiększenia mieści się w zakresie od 0 (wyświetlając cały świat) do 22 (wyświetlanie ulic i bloków).
Motywy map
Możesz pobrać kafelki z poniższych motywów.
Motyw mapy | Opis |
---|---|
Plan | Drogi, budynki, ciekawe miejsca i granice polityczne |
Satelita | Zdjęcia wykonane z kosmosu |
Teren | Mapa konturowa pokazująca obiekty naturalne, takie jak roślinność |
Aby zażądać kafelków mapy z interfejsu Map Tiles API, musisz najpierw zażądać tokena sesji. Token sesji śledzi bieżący stan mapy i widocznego obszaru. Podczas konfigurowania tokena sesji musisz ustawić wartość mapType
tak, aby pasowała do wybranego motywu mapy.
Następnie musisz umieścić token sesji w każdym żądaniu wysyłanym do interfejsu Map Tiles API.
Żądania informacji o widocznym obszarze
Widoczny obszar definiuje rozmiar ramki, która przedstawia scenę światową. Żądania informacji o widocznym obszarze zwracają szczegóły na temat kafelków mapy, które składają się na bieżący widoczny obszar. Dlatego prosisz o informacje o widocznym obszarze, ponieważ dzięki temu unikniesz żądań obrazów z nieobecnym poziomem powiększenia.
Na przykład w większości miast widać zdjęcia z powiększeniem 22, ale nie widać oceanu, ponieważ w ogóle to bezciemne niebieskie kwadraty.
Żądanie widocznego obszaru to żądanie HTTPS GET w tym formularzu.
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
Prośba zawiera te pola:
zoom
- Poziom powiększenia lupy.
north
,south
,east
,west
- Najbardziej wysunięta na północ, południe, wschód i zachodni punkt widocznego obszaru wyrażony w stopniach. Północ i południe muszą się mieścić w zakresie (-90,90), wschód i zachód muszą się mieścić w zakresie (-180, 180). Aby wyznaczyć granice przekraczające południk południowy, użyj wartości dodatniej (np. 170), a wschód może być ujemny (np. –170). Wszystkie parametry są wymagane.
Odpowiedzi na temat widocznego obszaru
Odpowiedź widocznego obszaru informuje, które obszary zawierają zdjęcia i na jakim poziomie powiększenia. Odpowiedź z informacją o widocznym obszarze ma następujący formularz.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
Treść odpowiedzi zawiera poniższe pola.
copyright
- Zawiera ciąg znaków atrybucji, który musisz wyświetlać na mapie, gdy wyświetlasz plan i kafelki satelitarne. Więcej informacji znajdziesz w zasadach dotyczących interfejsu API Map Tiles.
maxZoomRect
- Zawiera tablicę prostokątów ograniczających, które nakładają się na bieżący widoczny obszar. Określa też maksymalny poziom powiększenia dostępny w przypadku każdego prostokąta.
Funkcje współrzędnych
W większości języków programowania dostępne są narzędzia (proste funkcje), które można konwertować z par szerokości i długości geograficznej na współrzędne kafelków przy określonym powiększeniu.
Przyjrzyj się temu przykładowi kodu JavaScript, który najpierw konwertuje element latLng
na punkt, a następnie z punktu na współrzędne kafelka.
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}