Cartes de densité

La heatmapTiles fournit des cartes de densité liées à la qualité de l'air via une superposition de tuiles. Une vignette une superposition est un ensemble de tuiles d'images PNG pouvant être affichées au-dessus d'une Google Maps. La taille de chaque tuile d'image est de 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 des coordonnées (X,Y) attribuées. La tuile avec les coordonnées (0,0) se trouve toujours 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 du contenu d'une carte dans un la vue plan. La taille de la grille de tuiles est déterminée par la mise à l'échelle de 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 au format 4 x 4 pour un total de 16 tuiles. Le zoom détermine également la valeur maximale autorisé 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 forme de grille de 4 par 4.

Consultez les coordonnées de carte et de tuile. pour en savoir plus.

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

Une carte de densité est représentée par un tableau d'octets contenant les données des tuiles au format PNG l'image. Vous demandez des tuiles de carte de densité sur la qualité de l'air actuelles à l'aide des heatmapTiles en envoyant une requête HTTP GET à:

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 : carte de densité du type à renvoyer. Consultez les valeurs.

  • Z : niveau de zoom qui détermine la taille (grande ou petite) du contenu d'une carte sur une carte. Les valeurs autorisées sont comprises entre 0 et 16, où une valeur de 0 s'affiche le monde entier dans une seule tuile.

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

    Les coordonnées des tuiles 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 à de 10 et 10, l'API renvoie une erreur.

  • YOUR_API_KEY : la clé API de votre application. Cette clé identifie votre à des fins de gestion des quotas. Pour en savoir plus, consultez la section 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 la classe point de terminaison heatmapTiles pour demander la tuile aux coordonnées 0,1 à partir du carte de densité:

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

La vignette s'affiche comme suit:

Une tuile de carte de densité aux coordonnées 0,1.

Pour plus d’informations sur la superposition de tuiles sur la carte par défaut, voir Types de cartes de superposition