Mappe termiche

L'endpoint heatmapTiles fornisce mappe termiche relative alla qualità dell'aria tramite una sovrapposizione di riquadri. Una sovrapposizione di riquadri è una raccolta di riquadri di immagini PNG che possono essere visualizzati sopra 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 ognuno dei quali sono assegnate coordinate (X,Y). Il riquadro 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.

Il zoom level determina le dimensioni dei contenuti di una visualizzazione della mappa. Le dimensioni della griglia di riquadri sono determinate dalla scalabilità esponenziale delle coordinate X e Y 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. Per richiedere i riquadri della mappa termica della qualità dell'aria corrente utilizzando l' heatmapTiles endpoint, invia 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:

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

  • Z : il livello di zoom che determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. I valori consentiti sono 0-16, dove un valore pari a 0 mostra il mondo intero in un unico riquadro.

  • X,Y : le coordinate del riquadro da recuperare, rispetto 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 delle quote. Per saperne di più, consulta ottenere 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 con coordinate 0,1 dalla 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 in corrispondenza delle coordinate 0,1.

Per saperne di più sulla sovrapposizione di riquadri sopra la mappa predefinita, consulta Sovrapporre i tipi di mappe.