Wyświetlanie map pogodowych (eksperymentalne)

Punkt końcowy mapTypes udostępnia rastrowe fragmenty mapy przedstawiające różne zjawiska pogodowe, np. prognozy opadów. Te fragmenty mapy można nakładać na standardowe Mapy Google.

Warunki

Te warunki są wydawane zgodnie z sekcją 6 (Warunki ofert przed GA) Szczegółowych warunków korzystania z usługi Google Maps Platform Terms, które zostały uzgodnione przez Google i Ciebie.

1.1 Wymagania dotyczące atrybucji. Jeśli Klient korzysta z Treści Map Google z interfejsu Weather API, musi podać Google atrybucję w zgodzie z Dokumentacją.

1.2 Ograniczenia. Klienci nie mogą używać Treści Map Google pobranych z interfejsu Weather API do odtwarzania usługi lub produktu Google (np. używać danych pobranych z interfejsu Weather API w aplikacji pogodowej lub modelu pogodowym, których głównym celem jest dostarczanie informacji o pogodzie).

1.3 Pamięć podręczna. Klienci mogą tymczasowo zapisywać w pamięci podręcznej odpowiednie Treści Map Google z interfejsu Weather API przez odpowiedni Okres przechowywania w pamięci podręcznej, zgodnie z opisem w tabeli 1.3.1 (Uprawnienia do przechowywania w pamięci podręcznej).

Tabela 1.3.1 (Uprawnienia do przechowywania w pamięci podręcznej)

Te uprawnienia są dodatkowe w stosunku do uprawnień opisanych w tabeli 17.2.1 Szczegółowych warunków korzystania z usługi Google Maps Platform.

Treści Map Google Okres przechowywania w pamięci podręcznej
Fragmenty mapy w aplikacji Pogoda Godzina, po której Klient musi usunąć Treści Map Google z pamięci podręcznej

Informacje o żądaniach mapy w aplikacji Pogoda

Aby poprosić o mapy pogody, wyślij żądanie GET HTTP na adres:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

Typy map

Interfejs Weather API obsługuje różne typy map w aplikacji Pogoda, które odpowiadają różnym modelom pogodowym i obszarom geograficznym:

  • US_PRECIPITATION_CURRENT: prognoza krótkoterminowa opadów w Stanach Zjednoczonych w wysokiej rozdzielczości.
  • EU_PRECIPITATION_CURRENT: prognoza krótkoterminowa opadów w Europie w wysokiej rozdzielczości.

Poniższa mapa zasięgu przedstawia regiony, w których dostępne są fragmenty mapy w aplikacji Pogoda:

Zasięg kafelków mapy pogody

System współrzędnych mapy

Interfejs API używa standardowego systemu współrzędnych fragmentów mapy Web Mercator. Szczegółowe wyjaśnienie współrzędnych mapy i fragmentów mapy znajdziesz w artykułach Fragmenty mapy drogowej oraz Współrzędne mapy i fragmentu mapy.

W tym systemie:

  • zoom: poziom powiększenia (od 0 do 16). Poziom powiększenia 0 przedstawia cały świat na jednym fragmencie mapy (20 x 20 = 1 fragment). Poziom powiększenia z dzieli świat na siatkę 2z x 2z fragmentów mapy.
  • x: współrzędna X (kolumna) fragmentu mapy, od 0 (najbardziej na zachód) do 2zoom - 1 (najbardziej na wschód).
  • y: współrzędna Y (wiersz) fragmentu mapy, od 0 (najbardziej na północ) do 2zoom - 1 (najbardziej na południe).

Wyświetlanie mapy w aplikacji Pogoda

Aby wyświetlić te fragmenty mapy w aplikacji internetowej za pomocą interfejsu Maps JavaScript API, możesz utworzyć niestandardowy element google.maps.ImageMapType:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

Przykład żądania mapy w aplikacji Pogoda

Poniższy przykład żąda fragmentów mapy w aplikacji Pogoda przedstawiających opady w Nowym Orleanie:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

Odpowiedź jest binarna. Otoczka JSON pojawia się tylko w przypadku określonych ustawień serializacji, np. ?alt=json.