Mappe termiche

La heatmapTiles fornisce mappe termiche correlate alla qualità dell'aria attraverso una sovrapposizione di riquadri. Un riquadro overlay è una raccolta di riquadri di immagini PNG che possono essere visualizzati sopra un Google Maps. Ogni riquadro immagine ha una dimensione di 256 x 256 pixel.

Informazioni sui riquadri della mappa termica

L'overlay dei riquadri è una griglia composta da una serie di riquadri, a ciascuna coordinata (X,Y). Il riquadro con le coordinate (0,0) è sempre nell'angolo nord-ovest della mappa. I valori di X aumentano da ovest a est, mentre i valori di Y aumentano da nord a sud.

L'zoom level determina le dimensioni dei contenuti di una mappa in un visualizzazione mappa. Le dimensioni della griglia dei riquadri sono determinate ridimensionando X e Y le coordinate in modo esponenziale in base al livello di zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Ad esempio, con un livello di zoom pari a 2, il planisfero viene rappresentato con un'immagine 4 x 4 , per un totale di 16 riquadri. Lo zoom determina anche il valore massimo. consentito per le coordinate.

L'immagine seguente mostra una mappa termica US_AQI con un livello di zoom di 2, insieme alle coordinate di ciascun riquadro:

Una mappa termica del mondo intero come griglia 4 per 4.

Consulta le coordinate di mappa e riquadro per ulteriori dettagli.

Informazioni sull'endpoint della mappa termica

Un riquadro della mappa termica è rappresentato da un array di byte contenente i dati del riquadro in formato PNG dell'immagine. Per richiedere i riquadri della mappa termica attuale della qualità dell'aria, utilizzi il heatmapTiles tramite l'invio di una richiesta GET HTTP a:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Tutti i parametri della richiesta sono obbligatori in una richiesta:

  • TYPE: il tipo di mappa termica da restituire. Vedi consentiti personalizzati.

  • Z: il livello di zoom che determina le dimensioni dei contenuti di una mappa. appaiono in una visualizzazione mappa. I valori consentiti sono compresi tra 0 e 16, dove viene visualizzato un valore compreso tra 0 il mondo intero in un'unica casella.

  • X,Y: le coordinate del riquadro da recuperare, relative al nord angolo ovest (0,0). I valori di X sono in aumento da ovest a est e Y aumentano da nord a sud.

    Le coordinate dei riquadri devono essere valide per il livello di zoom specificato. Ad esempio, se imposti il livello di zoom su 2 e richiedi un riquadro coordinate di 10 e 10, l'API restituisce un errore.

  • YOUR_API_KEY: la chiave API dell'applicazione. Questa chiave identifica per la gestione della quota. Per ulteriori informazioni, consulta la sezione Come fare una chiave.

Esempio di richiesta di mappa termica

L'immagine sopra mostra una mappa termica US_AQI con un livello di zoom di 2, insieme alle coordinate di ciascun riquadro. L'esempio seguente utilizza il metodo Endpoint heatmapTiles per richiedere il riquadro nelle coordinate 0,1 dal mappa termica:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

Il riquadro viene visualizzato come:

Un riquadro della mappa termica con le coordinate 0,1.

Per ulteriori informazioni sulla sovrapposizione di riquadri sulla mappa predefinita, consulta Tipi di mappe di overlay.