Mappe termiche

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

L'overlay riquadri è una griglia assemblata da una raccolta di riquadri, a ognuno 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 di X aumentano da ovest a est, mentre i valori di Y aumentano da nord a sud.

Il zoom level determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. Le dimensioni della griglia dei riquadri sono determinate dalla scalabilità delle 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 è rappresentata utilizzando una matrice 4 x 4, per un totale di 16 riquadri.

L'immagine seguente mostra una mappa termica TREE_UPI del mondo intero, suddivisa in riquadri accessibili a un livello di zoom pari a 2.

Una mappa termica del mondo intero come griglia 4x4.

Per ulteriori dettagli, consulta Coordinate di mappa e riquadro.

Puoi richiedere i riquadri della mappa termica del polline attuale 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 riuscita:

  • 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. Vedi i valori consentiti.
  • Z: il livello di zoom che determina le dimensioni dei contenuti di una mappa in una visualizzazione della mappa. Sono consentiti valori compresi tra 0 e 16, dove un valore pari a 0 mostra il mondo intero in un'unica tessera.
  • X,Y: le coordinate del riquadro rispetto all'angolo nord-est (0,0). I valori di X aumentano da ovest a est e i valori di Y aumentano 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 della mappa termica

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

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

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

Esempio di un riquadro della mappa termica che utilizza la mappa TREE_UPI.

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