Mappe termiche

L'endpoint heatmapTiles fornisce mappe termiche correlate alla qualità dell'aria tramite un overlay di riquadri. Un overlay riquadro è una raccolta di riquadri di immagini PNG che possono essere visualizzati su 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 raccolta di riquadri, a cui sono state assegnate 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.

L'zoom level determina le dimensioni dei contenuti di una mappa in una visualizzazione mappa. Le dimensioni della griglia dei riquadri vengono determinate ridimensionando in modo esponenziale le coordinate X e Y 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 di 2, insieme alle coordinate di ciascun riquadro:

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

Per ulteriori dettagli, consulta Coordinate di mappa e riquadro.

Informazioni sull'endpoint della mappa termica

Un riquadro della mappa termica è rappresentato da un array di byte contenente i dati del riquadro sotto forma di immagine PNG. Puoi richiedere i riquadri delle mappe termiche attuali della 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 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 quanto sono grandi o piccoli i contenuti di una mappa in una visualizzazione mappa. I valori consentiti sono compresi tra 0 e 16, dove un valore pari a 0 mostra il mondo intero in un unico riquadro.

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

  • YOUR_API_KEY: la chiave API dell'applicazione. Questa chiave identifica l'applicazione ai fini della gestione della quota. Per ulteriori informazioni, consulta l'articolo Ricevere 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 l'endpoint heatmapTiles per richiedere il riquadro con le 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:

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

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