Cartes de densité

Le point de terminaison heatmapTiles fournit des cartes de densité liées à la qualité de l'air via une superposition de tuiles. Une superposition de tuiles est un ensemble de tuiles d'images PNG qui peuvent être affichées au-dessus d'une carte Google Maps. Chaque tuile d'image fait 256 x 256 pixels.

À propos des tuiles de carte de densité

La superposition de tuiles est une grille assemblée à partir d'un ensemble de tuiles, chacune se voyant attribuer 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.

Le zoom level détermine la taille d'affichage 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 de 4 x 4, soit un total de 16 tuiles. Le zoom détermine également la valeur maximale autorisée pour les coordonnées.

L'image suivante montre une carte de densité US_AQI avec un niveau de zoom de 2, ainsi que les coordonnées de chaque tuile :

Carte de densité du monde entier sous la forme d'une grille de 4 par 4.

Pour en savoir plus, consultez Coordonnées de carte et de tuile.

À propos du point de terminaison de la carte de densité

Une tuile de carte de densité est représentée par un tableau d'octets contenant les données de la tuile sous forme d'image PNG. Vous demandez des tuiles de carte de densité de la qualité de l'air actuelle à l'aide du point de terminaison heatmapTiles en envoyant une requête GET HTTP à :

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

Tous les paramètres de requête sont obligatoires dans une requête :

  • TYPE : type de carte de densité à renvoyer. Consultez les valeurs autorisées.

  • Z : niveau de zoom qui détermine la taille d'affichage du contenu d'une carte dans une vue de carte. Les valeurs autorisées sont comprises entre 0 et 16. Une valeur de 0 affiche le monde entier dans une seule tuile.

  • X,Y : coordonnées de la tuile à récupérer, par rapport à l'angle nord-ouest (0,0). Les valeurs X augmentent d'ouest en est et les valeurs Y augmentent du nord au sud.

    Les coordonnées de la tuile 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.

  • YOUR_API_KEY : clé API de votre application. Cette clé identifie votre application à des fins de gestion des quotas. Pour en savoir plus, consultez Obtenir une clé.

Exemple de requête de carte de densité

L'image ci-dessus montre une carte de densité US_AQI 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 0,1 de la carte de densité :

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

La tuile s'affiche comme suit :

Tuile de carte de densité aux coordonnées 0,1.

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