Visualizzare le mappe meteo (sperimentale)

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 alla versione standard di Google Maps.

Termini

Questi termini sono emessi ai sensi della Sezione 6 (Termini delle Offerte pre-GA) dei Termini specifici dei servizi della piattaforma Google Maps, come concordato da Google e dall'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 riportata di seguito mostra le regioni in cui sono disponibili i riquadri della mappa meteorologica:

Copertura dei 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 di mappe e riquadri, consulta Riquadri della roadmap e Coordinate di mappe e 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 riquadri.
  • x: la coordinata X (colonna) del riquadro, 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).

Visualizzare la mappa meteo

Per visualizzare questi riquadri 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 della 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.