Wyświetlanie map pogodowych (eksperymentalne)

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

Warunki

Te warunki są wydawane na podstawie artykułu 6 (Warunki oferty przed GA) Szczegółowych warunków korzystania z usługi Google Maps Platform, zgodnie z ustaleniami między Google a Tobą.

1.1 Wymagania dotyczące podania źródła. Jeśli Klient korzysta z Treści Map Google z interfejsu Weather API, musi podać Google jako źródło zgodnie z Dokumentacją.

1.2 Ograniczenia. Klienci nie mogą używać treści Map Google pobranych z interfejsu Weather API do odtworzenia 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 Zapisywanie w pamięci podręcznej. 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 zapisywania w pamięci podręcznej).

Tabela 1.3.1 (Uprawnienia do buforowania)

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

Treści w Mapach Google Okres buforowania
Fragmenty mapy pogodowej 1 godzina, po której Klient musi usunąć Treści Map Google z pamięci podręcznej.

Informacje o prośbach o mapę pogodową

Aby poprosić o mapy pogodowe, 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 pogodowych, które odpowiadają różnym podstawowym 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.

Mapa zasięgu poniżej pokazuje regiony, w których dostępne są kafelki mapy pogodowej:

Zasięg kafelków mapy pogodowej

System współrzędnych mapy

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

W tym systemie:

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

Wyświetlanie mapy pogodowej

Aby wyświetlić te kafelki w aplikacji internetowej za pomocą interfejsu Google Maps JavaScript API, możesz utworzyć niestandardowy obiekt 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 prośby o mapę pogody

Poniższy przykład dotyczy kafelków mapy pogodowej z opadami w Nowym Orleanie w Stanach Zjednoczonych:

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. Opakowanie JSON pojawia się tylko w przypadku określonych ustawień serializacji, takich jak ?alt=json.