Cartes de densité

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'image pouvant être affichées sur 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 étant associée à des coordonnées (X,Y). La tuile avec les coordonnées (0,0) est toujours à 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.

Le zoom level détermine la taille et la taille du contenu d'une carte dans une vue de carte. La taille de la grille de tuiles est déterminée en mettant à l'échelle les coordonnées X et Y de manière exponentielle en fonction du niveau de zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Par exemple, à un niveau de zoom de 2, la carte du monde est représentée à l'aide d'une matrice 4 x 4, soit un total de 16 tuiles.

L'image suivante montre une carte de densité TREE_UPI du monde entier, divisée en tuiles accessibles avec un niveau de zoom de 2.

Une carte de densité du monde entier sous forme de grille de 4 par 4.

Pour en savoir plus, consultez Coordonnées des cartes et des tuiles.

Vous pouvez demander des tuiles de carte de densité du pollen actuelles à 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 répertoriés ci-dessous sont obligatoires pour que la requête aboutisse:

  • 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 et la taille du contenu d'une carte. Les valeurs autorisées vont de 0 à 16, où une valeur de 0 affiche le monde entier dans une seule tuile.
  • X,Y: coordonnées de la tuile par rapport à l'angle nord-est (0,0). Les valeurs X augmentent d'ouest en est et les valeurs Y augmentent 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 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 tuile. L'exemple suivant utilise le point de terminaison heatmapTiles pour demander la tuile aux coordonnées (2,1):

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

La tuile apparaît sous la forme d'une image qui peut être superposée à une carte:

Exemple de tuile d'une carte de densité utilisant la carte TREE_UPI

Pour en savoir plus sur la superposition de tuiles sur la carte par défaut, consultez Types de cartes de superposition.