Тепловые карты

Конечная точка heatmapTiles предоставляет тепловые карты, связанные с пыльцой, посредством наложения тайлов. Наложение тайлов — это набор графических тайлов, которые можно отображать поверх Google Maps. Каждый графический тайл имеет размер 256 x 256 пикселей.

Наложение тайлов представляет собой сетку, собранную из набора тайлов, каждому из которых присвоены координаты ( X , Y ). Тайл с координатами (0,0) всегда находится в северо-западном углу карты. Значения X увеличиваются с запада на восток, а значения Y — с севера на юг.

zoom level определяет, насколько крупными или мелкими будут отображаться элементы карты в режиме просмотра карты. Размер сетки тайлов определяется путем экспоненциального масштабирования координат X и Y в зависимости от уровня масштабирования.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Например, при уровне масштабирования 2 карта мира отображается с помощью матрицы 4 x 4, всего 16 тайлов.

На следующем изображении представлена ​​тепловая карта TREE_UPI всего мира, разделенная на фрагменты, доступ к которым осуществляется при уровне масштабирования 2.

Тепловая карта всего мира в виде сетки 4 на 4.

Дополнительные сведения см. на карте и в координатах фрагментов .

Вы можете запросить актуальные фрагменты тепловой карты пыльцы, используя конечную точку heatmapTiles , отправив HTTP GET-запрос по адресу:

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

О конечной точке тепловой карты

Для успешного выполнения запроса необходимы все перечисленные ниже параметры:

  • KEY : API-ключ вашего приложения. Этот ключ идентифицирует ваше приложение для целей управления квотами. Узнайте, как получить ключ .
  • TYPE : Тип возвращаемой тепловой карты. См. допустимые значения .
  • Z : Уровень масштабирования, определяющий размер содержимого карты в режиме просмотра карты. Допустимые значения: 0-16, при этом значение 0 отображает весь мир в одном тайле.
  • X , Y : Координаты тайла относительно северо-восточного угла (0,0). Значения X увеличиваются с запада на восток, а значения Y — с севера на юг. Координаты должны быть действительны для указанного уровня масштабирования. Например, если вы установите уровень масштабирования на 2 и запросите тайл с координатами (10,10), API вернет ошибку.

Пример запроса тепловой карты

На изображении выше показана тепловая карта TREE_UPI с уровнем масштабирования 2, а также координаты каждого фрагмента. В следующем примере используется конечная точка heatmapTiles для запроса фрагмента с координатами (2,1):

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

Этот фрагмент карты отображается в виде изображения, которое можно наложить на карту:

Пример фрагмента тепловой карты, созданного с использованием карты TREE_UPI.

Для получения дополнительной информации о наложении фрагментов поверх карты по умолчанию см. раздел «Типы наложенных карт» .