Mappe termiche

L'endpoint heatmapTiles fornisce mappe termiche relative alla qualità dell'aria tramite un overlay di riquadri. Un overlay riquadro è una raccolta di riquadri di immagini PNG che possono essere visualizzati sopra una mappa di Google Maps. Ogni riquadro di immagine è di 256 x 256 pixel.

Informazioni sui riquadri della mappa termica

L'overlay riquadri è una griglia assemblata da una raccolta di riquadri, a ciascuno dei quali sono assegnate le coordinate (X,Y). La sezione con coordinate (0,0) si trova sempre nell'angolo nord-ovest della mappa. I valori X aumentano da ovest a est, mentre i valori Y aumentano da nord a sud.

zoom level determina le dimensioni dei contenuti di una mappa in una visualizzazione mappa. La dimensione della griglia dei riquadri viene determinata scalando le coordinate X e Y in modo esponenziale in base al livello di zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Ad esempio, con un livello di zoom pari a 2, la mappa del mondo è rappresentata utilizzando una matrice 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 pari a 2, insieme alle coordinate di ogni riquadro:

Una mappa termica del mondo intero sotto forma di griglia 4x4.

Per ulteriori dettagli, consulta Coordinate della mappa e dei riquadri.

Informazioni sull'endpoint della mappa termica

Un riquadro della mappa termica è rappresentato da un array di byte contenente i dati del riquadro come immagine PNG. Puoi richiedere i riquadri della mappa termica della qualità dell'aria attuale utilizzando l'endpoint heatmapTiles inviando una richiesta GET HTTP a:

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

Tutti i parametri di richiesta sono obbligatori in una richiesta:

  • TYPE: il tipo di mappa termica da restituire. Consulta i valori consentiti.

  • Z: livello di zoom che determina le dimensioni dei contenuti di una mappa visualizzati in una visualizzazione mappa. I valori consentiti sono compresi tra 0 e 16, dove un valore pari a 0 mostra l'intero mondo in un singolo riquadro.

  • X,Y: le coordinate del riquadro da recuperare, relative all'angolo nord-ovest (0,0). I valori X aumentano da ovest a est e i valori 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 con coordinate 10,10, l'API restituisce un errore.

  • YOUR_API_KEY: la chiave API della tua applicazione. Questa chiave identifica la tua applicazione ai fini della gestione della quota. Per saperne di più, consulta Ottieni una chiave.

Esempio di richiesta di mappa termica

L'immagine sopra mostra una mappa termica US_AQI con un livello di zoom pari a 2, insieme alle coordinate di ogni riquadro. L'esempio seguente utilizza l'endpoint heatmapTiles per richiedere il riquadro alle coordinate 0,1 dalla mappa di calore:

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 alle coordinate 0,1.

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