Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 qui peuvent être affichées au-dessus de Google Maps. Chaque tuile d'image fait 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 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.
La valeur zoom level détermine 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, au niveau de zoom 2, la carte du monde est représentée à l'aide d'une matrice 4x4, soit un total de 16 tuiles.
L'image suivante montre une carte thermique TREE_UPI du monde entier, divisée en tuiles accessibles au niveau de zoom 2.
Vous pouvez demander les tuiles actuelles de la carte thermique des pollens à l'aide du point de terminaison
heatmapTiles en envoyant une requête HTTP GET à l'adresse suivante :
À propos du point de terminaison de la carte de densité
Tous les paramètres listés ci-dessous sont obligatoires pour que la requête soit traité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é à renvoyer. Consultez les valeurs autorisées.
Z : niveau de zoom qui détermine la taille du contenu d'une carte dans une vue de carte. Les valeurs autorisées sont comprises entre 0 et 16. La valeur 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 le bloc aux coordonnées (2,1) :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe heatmapTiles endpoint delivers pollen heatmaps as tile overlays, which are collections of 256x256 pixel image tiles displayed on top of Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eTile coordinates (X,Y) determine the grid position, with (0,0) at the northwest corner and increasing values eastward for X and southward for Y.\u003c/p\u003e\n"],["\u003cp\u003eZoom level (Z) controls map content size and grid dimensions, ranging from 0 (entire world) to 16, influencing tile coordinates validity.\u003c/p\u003e\n"],["\u003cp\u003eTo request heatmap tiles, use the heatmapTiles endpoint with required parameters: API key, heatmap type, zoom level, and tile coordinates (X,Y).\u003c/p\u003e\n"],["\u003cp\u003eYou can overlay these pollen heatmap tiles onto existing maps for visualization, enhancing applications with pollen information.\u003c/p\u003e\n"]]],["The `heatmapTiles` endpoint provides pollen heatmaps as image tiles (256x256 pixels) overlaid on Google Maps. Tiles are arranged in a grid with (X,Y) coordinates, starting from (0,0) in the northwest. The zoom level (0-16) dictates map detail, scaling the grid exponentially (gridSizeX = X^zoomLevel). A request to the endpoint requires an API key, heatmap `TYPE`, `Z` zoom level, and `X`, `Y` tile coordinates. The format for a request is: `https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY`\n"],null,["# Heatmaps\n\nThe\n[heatmapTiles](/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint provides pollen-related heatmaps through tile overlay. A tile overlay\nis a collection of image tiles that can be displayed on top of Google Maps. Each\nimage tile is 256 x 256 pixels.\n\nThe tile overlay is a grid assembled from a collection of tiles, each assigned\n(`X`,`Y`) coordinates. The tile with coordinates (0,0) is always at the\nnorthwest corner of the map. The `X` values increase from west to east, while\nthe `Y` values increase from north to south.\n\nThe `zoom level` determines how large or small the contents of a map appear in a\nmap view. The tile grid size is determined by scaling the `X` and `Y`\ncoordinates exponentially by the zoom level. \n\n```text\ngridSizeX = XzoomLevel\ngridSizeY = YzoomLevel\n```\n\nFor example, at a zoom level of 2, the world map is represented using a 4 x 4\nmatrix, for a total of 16 tiles.\n\nThe following image shows a `TREE_UPI` heatmap of the entire world, sectioned\ninto tiles that can be accessed at a zoom level of 2.\n\nSee [Map and Tile\ncoordinates](/maps/documentation/javascript/coordinates#tile-coordinates) for\nadditional details.\n\nYou can request current pollen heatmap tiles using the [heatmapTiles](/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint by sending an HTTP GET request to: \n\n```html\nhttps://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY\n```\n\nAbout the heatmap endpoint\n--------------------------\n\nAll parameters listed below are required for a successful request:\n\n- `KEY`: Your application's API key. This key identifies your application for purposes of quota management. Learn how to [get a\n key](/maps/documentation/pollen/get-api-key).\n- `TYPE`: The type of heatmap to return. See [allowed\n values](/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile#maptype).\n- `Z`: Zoom level that determines how large or small the contents of a map appear in a map view. Allowed values are 0-16, where a value of 0 displays the entire world in a single tile.\n- `X`,`Y`: The tile coordinates relatively to the north east corner (0,0). `X` values increase from west to east and `Y` values increase from north to south. Coordinates must be valid for the specified zoom level. For example, if you set the zoom level to 2 and request a tile at coordinates (10,10), the API returns an error.\n\nExample heatmap request\n-----------------------\n\nThe image above shows a `TREE_UPI` heatmap with a zoom level of 2, along with\nthe coordinates of each tile. The following example uses the `heatmapTiles`\nendpoint to request the tile at coordinates (2,1): \n\n```html\nhttps://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY\n```\n\nThe tile appears as an image that can be overlaid on a map:\n\nFor more information on overlaying tiles on top of the default map, see\n[Overlay Map Types](/maps/documentation/javascript/examples/maptype-overlay)."]]
