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

Конечная точка 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-ключ вашего приложения. Этот ключ идентифицирует ваше приложение для целей управления квотами. Для получения дополнительной информации см. get a key .

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

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

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

Плитка выглядит так:

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

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