Punkt końcowy mapTypes udostępnia kafelki mapy rastrowej przedstawiające różne zjawiska pogodowe, takie jak prognozy opadów. Te kafelki mapy można nakładać na standardowe Mapy Google.
Warunki
Te warunki są wydawane na podstawie sekcji 6 (Warunki ofert przed GA) Szczegółowych warunków korzystania z usługi Google Maps Platform, 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 informacje o autorstwie zgodnie z Dokumentacją.
1.2 Ograniczenia. Klienci nie mogą używać treści z 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 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 zapisywania 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ą dodatkowe w stosunku do uprawnień opisanych w tabeli 17.2.1 Szczegółowych warunków korzystania z usługi Google Maps Platform.
| Treści w Mapach Google | Okres przechowywania w pamięci podręcznej |
|---|---|
| Kafelki mapy pogody | 1 godzina, po której Klient musi usunąć Treści Map Google z pamięci podręcznej. |
Informacje o prośbach dotyczących mapy pogody
Aby poprosić o mapy pogodowe, wyślij żądanie GET 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 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 pogody:
System współrzędnych mapy
Interfejs API korzysta ze standardowego układu współrzędnych kafelków Web Mercator. Szczegółowe wyjaśnienie współrzędnych mapy i kafelka znajdziesz w sekcjach Kafelki mapy drogowej i Współrzędne mapy i kafelka.
W tym systemie:
zoom: poziom powiększenia (od 0 do 16). Poziom powiększenia 0 obejmuje cały świat w jednym kafelku (20 x 20 = 1 kafelek). Poziom powiększenia z dzieli świat na siatkę 2z x 2z kafelków.x: współrzędna X (kolumna) kafelka w zakresie od 0 (najbardziej na zachód) do 2zoom – 1 (najbardziej na wschód).y: współrzędna Y (wiersz) kafelka w zakresie od 0 (najbardziej na północ) do 2zoom – 1 (najbardziej na południe).
Wyświetlanie mapy pogody
Aby wyświetlać te kafelki w aplikacji internetowej za pomocą interfejsu 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 żądania mapy pogody
W tym przykładzie żądamy kafelków mapy opadów w Stanach Zjednoczonych dla Nowego Orleanu:
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.