Le point de terminaison heatmapTiles fournit des cartes de densité liées au pollen via une superposition de tuiles. Une superposition de tuiles est un ensemble de tuiles d'images pouvant être affichées au-dessus de Google Maps. Chaque tuile d'image mesure 256 x 256 pixels.
La superposition de tuiles est une grille assemblée à partir d'un ensemble de tuiles, à chacune desquelles sont attribuées des coordonnées (X,Y). La tuile avec les coordonnées (0,0) est toujours située dans l'angle nord-ouest de la carte. Les valeurs X augmentent d'ouest en est, tandis que les valeurs Y augmentent du nord au sud.
zoom level détermine la taille du contenu d'une carte dans une vue cartographique. La taille de la grille de tuiles est déterminée en étirant les coordonnées X et Y de manière exponentielle en fonction du niveau de zoom.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Par exemple, au niveau de zoom 2, la carte du monde est représentée à l'aide d'une matrice de 4 x 4, pour un total de 16 tuiles.
L'image suivante montre une carte thermique TREE_UPI de l'ensemble du monde, divisée en tuiles accessibles à un niveau de zoom de 2.
Pour en savoir plus, consultez la section Coordonnées de la carte et des tuiles.
Vous pouvez demander les tuiles de la carte thermique actuelle des pollens à l'aide du point de terminaison heatmapTiles en envoyant une requête HTTP GET à:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
À propos du point de terminaison de la carte de densité
Tous les paramètres listés ci-dessous sont obligatoires pour qu'une requête soit acceptée:
KEY: clé API de votre application. Cette clé identifie votre application à des fins de gestion des quotas. Découvrez comment obtenir une clé.TYPE: type de carte de densité à afficher. Consultez les valeurs autorisées.Z: niveau de zoom qui détermine la taille du contenu d'une carte dans une vue cartographique. Les valeurs autorisées sont comprises entre 0 et 16, une valeur de 0 affichant le monde entier dans une seule tuile.X,Y: coordonnées de la carte par rapport au coin nord-est (0,0). Les valeursXaugmentent d'ouest en est, et les valeursYaugmentent du nord au sud. Les coordonnées doivent être valides pour le niveau de zoom spécifié. Par exemple, si vous définissez le niveau de zoom sur 2 et que vous demandez une tuile aux coordonnées (10,10), l'API renvoie une erreur.
Exemple de requête de carte de densité
L'image ci-dessus montre une carte de densité TREE_UPI avec un niveau de zoom de 2, ainsi que les coordonnées de chaque carte. L'exemple suivant utilise le point de terminaison heatmapTiles pour demander la carte aux coordonnées (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
La carte s'affiche sous la forme d'une image pouvant être superposée à une carte:
Pour en savoir plus sur la superposition de tuiles sur la carte par défaut, consultez la section Types de cartes superposées.