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

Конечная точка heatmapTiles предоставляет тепловые карты, связанные с качеством воздуха, в виде тайловых наложений. Тайловое наложение представляет собой набор PNG-изображений, которые можно отображать поверх карты Google Maps. Каждое изображение имеет размер (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.

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