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

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

О фрагментах тепловой карты

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Например, на уровне масштабирования 2 карта мира представлена матрицей 4 x 4, то есть состоит из 16 фрагментов. Масштаб также определяет максимальное значение, допустимое для координат.

На изображении ниже показана тепловая карта US_AQI с уровнем масштабирования 2 и координатами каждого фрагмента:

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

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

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

Фрагмент тепловой карты представлен массивом байтов, содержащим данные фрагмента в виде изображения PNG. Чтобы запросить фрагменты тепловой карты текущего качества воздуха, отправьте HTTP-запрос GET к конечной точке heatmapTiles:

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

Все параметры запроса являются обязательными:

  • TYPE – тип тепловой карты, которую нужно вернуть. Ознакомьтесь с допустимыми значениями.

  • Z – уровень масштабирования, определяющий, насколько крупно или мелко отображается содержимое карты. Допустимые значения: 0–16. При значении 0 весь мир отображается на одном фрагменте.

  • X,Y – координаты фрагмента, который нужно получить, относительно северо-западного угла (0,0). Значения X увеличиваются с запада на восток, а значения Y – с севера на юг.

    Координаты фрагмента должны быть действительными для указанного уровня масштабирования. Например, если вы установите уровень масштабирования 2 и запросите фрагмент с координатами 10,10, API вернет ошибку.

  • YOUR_API_KEY – ключ API вашего приложения. Этот ключ идентифицирует ваше приложение для управления квотами. Подробнее о том, как получить ключ…

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

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

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

Элемент выглядит следующим образом:

Фрагмент тепловой карты с координатами 0,1.

Подробнее о том, как накладывать фрагменты поверх карты по умолчанию, читайте в статье Типы наложений.