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

Конечная точка HeatmapTiles предоставляет тепловые карты, связанные с пыльцой, посредством наложения плиток. Наложение плиток – это набор плиток изображений, которые можно отображать поверх Карт Google. Размер каждого фрагмента изображения составляет 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.

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