Mappe termiche

L'endpoint heatmapTiles fornisce mappe termiche relative al polline tramite il rivestimento delle schede. Un overlay a riquadri è una raccolta di riquadri di immagini che possono essere visualizzati sopra Google Maps. Ogni riquadro di immagine ha una dimensione di 256 x 256 pixel.

L'overlay riquadri è una griglia assemblata da una raccolta di riquadri, a ciascuno 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 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.

L'immagine seguente mostra una mappa di calore TREE_UPI dell'intero mondo, suddivisa in riquadri a cui è possibile accedere con un livello di zoom pari a 2.

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

Per ulteriori dettagli, consulta Coordinate mappa e mappale.

Puoi richiedere i riquadri della mappa di calore del polline attuali utilizzando l'endpoint heatmapTiles inviando una richiesta HTTP GET a:

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Informazioni sull'endpoint della mappa termica

Tutti i parametri elencati di seguito sono obbligatori per una richiesta andata a buon fine:

  • KEY: la chiave API della tua applicazione. Questa chiave identifica la tua applicazione ai fini della gestione delle quote. Scopri come ottenere una chiave.
  • TYPE: il tipo di mappa di calore da restituire. Consulta i valori consentiti.
  • Z: livello di zoom che determina le dimensioni dei contenuti di una mappa visualizzati in una visualizzazione 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 del riquadro rispetto all'angolo nord-est (0,0). I valori X aumentano da ovest verso est e i valori Y da nord a sud. Le coordinate 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.

Esempio di richiesta di mappa termica

L'immagine sopra mostra una mappa termica TREE_UPI 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 (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

Il riquadro viene visualizzato come immagine che può essere sovrapposta a una mappa:

Un esempio di un riquadro della mappa termica che utilizza la mappa TREE_UPI.

Per saperne di più sull'applicazione di riquadri in overlay sulla mappa predefinita, consulta Tipi di mappe in overlay.