Mappe termiche

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

Informazioni sui riquadri della mappa termica

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

zoom level determina quanto grandi o piccoli devono essere visualizzati in una visualizzazione mappa dei contenuti di una 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, a un livello di zoom pari a 2, la mappa del mondo viene 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 4 x 4.

Per ulteriori dettagli, consulta Coordinate mappa e riquadri.

Informazioni sull'endpoint della mappa termica

Un riquadro di una mappa termica è rappresentato da un array di byte contenente i dati del riquadro sotto forma di immagine PNG. Puoi richiedere i riquadri attuali della mappa termica sulla qualità dell'aria 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 sono obbligatori in una richiesta:

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

  • Z - Livello di zoom che determina quanto grande o piccolo i contenuti di una mappa vengono mostrati in una visualizzazione mappa. I valori consentiti sono 0-16, dove il valore 0 mostra il mondo intero in un singolo riquadro.

  • X,Y - Le coordinate del riquadro da recuperare, rispetto all'angolo nord-ovest (0,0). I valori di X sono in aumento da ovest a est, mentre i valori di 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 di 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 ulteriori informazioni, consulta la sezione per ottenere una chiave.

Esempio di richiesta di mappa termica

L'immagine riportata 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 della mappa termica:

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

Il riquadro viene visualizzato come segue:

Un riquadro della mappa termica alle coordinate 0,1.

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