Omówienie kart 2D

Przykład planuKafelki 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
  };
}