L'endpoint mapTypes fornisce riquadri di mappe raster che rappresentano vari fenomeni meteorologici, come le previsioni delle precipitazioni. Queste sezioni della mappa possono essere sovrapposte
a Google Maps standard.
Termini
Questi termini sono emessi ai sensi della Sezione 6 (Termini delle offerte pre-GA) dei Termini specifici di servizio di Google Maps Platform, come concordato da Google e dall'utente.
1.1 Requisiti di attribuzione. Se il Cliente utilizza i contenuti di Google Maps dell'API Weather, deve fornire l'attribuzione a Google in conformità alla Documentazione.
1.2 Limitazioni. I clienti non possono utilizzare i contenuti di Google Maps recuperati dall'API Weather per ricreare un servizio o un prodotto Google (ad es. utilizzare i dati recuperati dall'API Weather in un'app meteo o in un modello meteo il cui scopo principale è fornire informazioni meteo).
1.3 Memorizzazione nella cache. I clienti possono memorizzare temporaneamente nella cache i Contenuti di Google Maps applicabili dell'API Weather per il Periodo di memorizzazione nella cache applicabile, come descritto nella Tabella 1.3.1 (Autorizzazioni di memorizzazione nella cache).
Tabella 1.3.1 (autorizzazioni di memorizzazione nella cache)
Queste autorizzazioni si aggiungono a quelle descritte nella Tabella 17.2.1 dei Termini specifici di servizio di Google Maps Platform.
| Contenuti di Google Maps | Periodo di memorizzazione nella cache |
|---|---|
| Riquadri della mappa meteo | Un'ora, dopodiché il Cliente deve eliminare i Contenuti di Google Maps memorizzati nella cache |
Informazioni sulle richieste di mappe meteo
Per richiedere le mappe meteo, invia una richiesta GET HTTP a:
https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}Tipi di mappe
L'API Weather supporta diversi tipi di mappe meteo, che corrispondono a diversi modelli meteo sottostanti e aree geografiche:
US_PRECIPITATION_CURRENT: Nowcast delle precipitazioni negli Stati Uniti ad alta risoluzione.EU_PRECIPITATION_CURRENT: Previsione immediata delle precipitazioni in Europa ad alta risoluzione.
La mappa di copertura riportata di seguito mostra le regioni in cui sono disponibili i riquadri della mappa meteo:
Sistema di coordinate dei riquadri
L'API utilizza il sistema di coordinate delle tessere Web Mercator standard. Per una spiegazione completa delle coordinate della mappa e delle coordinate dei riquadri, consulta Riquadri della roadmap e Coordinate della mappa e delle coordinate dei riquadri.
In questo sistema:
zoom: il livello di zoom (da 0 a 16). Il livello di zoom 0 rappresenta il mondo intero in un'unica tessera (20 x 20 = 1 tessera). Il livello di zoom z divide il mondo in una griglia di 2z x 2z tessere.x: la coordinata X (colonna) del riquadro, compresa tra 0 (più a ovest) e 2zoom - 1 (più a est).y: la coordinata Y (riga) del riquadro, compresa tra 0 (più a nord) e 2zoom - 1 (più a sud).
Visualizzare la mappa meteo
Per visualizzare queste tessere in un'applicazione web utilizzando l'API Maps JavaScript, puoi creare un google.maps.ImageMapType personalizzato:
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);
Esempio di richiesta di mappa meteo
L'esempio seguente richiede i riquadri della mappa meteo delle precipitazioni negli Stati Uniti per New Orleans:
curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"
La risposta è binaria. Il wrapper JSON viene visualizzato solo in impostazioni di serializzazione specifiche, ad esempio ?alt=json.