L'endpoint heatmapTiles fornisce mappe termiche relative al polline tramite overlay riquadri. Un overlay di riquadri è una raccolta di riquadri di immagini che possono essere visualizzati su Google Maps. Ogni riquadro immagine è di 256 x 256 pixel.
L'overlay dei riquadri è una griglia composta da una raccolta di riquadri, a cui 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 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.
L'immagine seguente mostra una mappa termica TREE_UPI
dell'intero mondo, suddivisa
in riquadri a cui è possibile accedere con un livello di zoom pari a 2.
Consulta Coordinate di mappa e riquadro per ulteriori dettagli.
Puoi richiedere i riquadri delle mappe termiche attuali della concentrazione di pollini 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
Per una richiesta corretta sono necessari tutti i parametri elencati di seguito:
KEY
: la chiave API dell'applicazione. Questa chiave identifica l'applicazione ai fini della gestione della quota. Scopri come ottenere una chiave.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
: il riquadro viene coordinato in modo relativo all'angolo nord-est (0,0). I valori diX
aumentano da ovest a est e i valori diY
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 in corrispondenza delle 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 di 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 ha l'aspetto di un'immagine che può essere sovrapposta a una mappa:
Per ulteriori informazioni sulla sovrapposizione di riquadri alla mappa predefinita, consulta Tipi di mappe overlay.