L'endpoint mapTypes fornisce riquadri della mappa raster che rappresentano vari fenomeni meteorologici, ad esempio le previsioni delle precipitazioni. Questi riquadri della mappa possono essere sovrapposti a Google Maps standard.
Termini
Questi termini sono emessi ai sensi della Sezione 6 (Termini delle offerte pre-GA) dei Termini specifici dei servizi 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 dall'API Weather, deve fornire l'attribuzione a Google in conformità con la 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 o in un modello meteo 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 dall'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 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 meteorologici e aree geografiche sottostanti:
US_PRECIPITATION_CURRENT: nowcast delle precipitazioni ad alta risoluzione negli Stati Uniti.EU_PRECIPITATION_CURRENT: nowcast delle precipitazioni ad alta risoluzione in Europa.
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 dei riquadri 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 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 singolo riquadro (20 x 20 = 1 riquadro). Il livello di zoom z divide il mondo in una griglia di riquadri 2z x 2z.x: la coordinata X (colonna) del riquadro, che va da 0 (più a ovest) a 2zoom - 1 (più a est).y: la coordinata Y (riga) del riquadro, che va da 0 (più a nord) a 2zoom - 1 (più a sud).
Visualizzare la mappa meteo
Per visualizzare questi riquadri 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.