Mappe termiche

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

Informazioni sui riquadri della mappa termica

L'overlay riquadri è una griglia assemblata da una raccolta di riquadri, a ognuno dei quali sono assegnate coordinate (X,Y). Il riquadro con le coordinate (0,0) si trova 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.

Il zoom level determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. Le dimensioni della griglia dei riquadri sono determinate dalla scalabilità delle coordinate X e Y in modo esponenziale in base al livello di zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Ad esempio, a 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 come griglia 4x4.

Per ulteriori dettagli, consulta Coordinate di mappe e 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. Richiedi i riquadri della mappa termica della qualità dell'aria attuale utilizzando l'endpoint heatmapTiles inviando una richiesta HTTP GET 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 i valori consentiti.

  • Z: il livello di zoom che determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. Sono consentiti valori compresi tra 0 e 16, dove un valore pari a 0 mostra il mondo intero in un'unica tessera.

  • X,Y: le coordinate del riquadro da recuperare, relative all'angolo nord-ovest (0,0). I valori di X aumentano da ovest a est e i valori di Y aumentano da nord a sud.

    Le coordinate del riquadro devono essere valide per il livello di zoom specificato. Ad esempio, se imposti il livello di zoom su 2 e richiedi un riquadro alle 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 delle quote. Per saperne di più, consulta Ottenere una chiave.

Esempio di richiesta della 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 in corrispondenza delle coordinate 0,1.

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