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

Конечная точка 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-изображения. Для запроса плиток текущей тепловой карты качества воздуха используется конечная точка heatmapTiles , отправляя HTTP-запрос GET по адресу:

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.

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