L'endpoint mapTypes fornisce riquadri di mappe raster che rappresentano vari fenomeni meteorologici, come le previsioni delle precipitazioni. Questi riquadri della mappa possono essere sovrapposti a Google Maps standard.
Termini
I presenti termini vengono emessi ai sensi della Sezione 6 (Termini delle Offerte pre-GA) dei Termini di servizio specifici di Google Maps Platform, come concordato tra Google e l'utente.
1.1 Requisiti di attribuzione. Il Cliente deve fornire l'attribuzione a Google in conformità alla Documentazione se utilizza i Contenuti di Google Maps dell'API Weather.
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 esempio, utilizzare i dati recuperati dall'API Weather in un'app o un modello meteorologico il cui scopo principale è fornire informazioni meteorologiche).
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 dei servizi 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 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 meteorologici e aree geografiche sottostanti:
US_PRECIPITATION_CURRENT: previsione immediata delle precipitazioni negli Stati Uniti ad alta risoluzione.EU_PRECIPITATION_CURRENT: previsione immediata delle precipitazioni in Europa ad alta risoluzione.
La mappa di copertura 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 dei riquadri Web Mercator standard. Per una spiegazione completa delle coordinate della mappa e delle coordinate dei riquadri, consulta Riquadri della mappa stradale e Coordinate della mappa e dei riquadri.
In questo sistema:
zoom: il livello di zoom (da 0 a 16). Il livello di zoom 0 rappresenta l'intero mondo in un'unica sezione (20 x 20 = 1 sezione). Il livello di zoom z divide il mondo in una griglia di 2z x 2z riquadri.x: la coordinata X (colonna) della sezione, compresa tra 0 (più a ovest) e 2zoom - 1 (più a est).y: la coordinata Y (riga) della sezione, compresa tra 0 (più a nord) e 2zoom - 1 (più a sud).
Visualizza la mappa meteo
Per visualizzare queste schede in un'applicazione web utilizzando l'API Maps JavaScript di Google, 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.