Heatmaps

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

Informazioni sui riquadri della mappa termica

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

zoom level determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. Le dimensioni della griglia dei riquadri sono determinate ridimensionando 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 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 2, insieme alle coordinate di ogni riquadro:

Una mappa termica dell'intero mondo sotto forma di griglia 4 x 4.

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. Puoi richiedere i riquadri della mappa di calore della qualità dell'aria corrente 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 di richiesta sono obbligatori in una richiesta:

  • 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 compresi tra 0 e 16, dove un valore pari a 0 mostra l'intero mondo in un unico riquadro.

  • X,Y: le coordinate della scheda da recuperare rispetto all'angolo nord-ovest (0,0). I valori X aumentano da ovest verso est e i valori Y aumentano da nord verso 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 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 ulteriori informazioni, vedi Ottenere una chiave.

Esempio di richiesta di mappa termica

L'immagine sopra mostra una mappa termica US_AQI con un livello di zoom 2, insieme alle coordinate di ogni riquadro. L'esempio seguente utilizza l'endpoint heatmapTiles per richiedere il riquadro alle coordinate 0,1 della 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 saperne di più sull'applicazione di riquadri in overlay sulla mappa predefinita, consulta Tipi di mappe in overlay.