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

Конечная точка 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.

Подробнее о координатах карт и фрагментов…

Чтобы запросить текущие фрагменты тепловой карты пыльцы, отправьте HTTP-запрос GET к конечной точке heatmapTiles:

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.

Подробнее о наложении тайлов на карту по умолчанию рассказывается в разделе Типы наложений.