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

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

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