Эта страница переведена с помощью Cloud Translation API.

Осведомленность о качестве воздуха для мест с использованием Air Quality API

В этом документе вы узнаете, как использовать API качества воздуха для создания многофункциональных интерфейсов поиска мест. Мы покажем, как качество воздуха может служить индикатором ценности для пользователей на всех этапах воронки продаж, и как данные API качества воздуха могут быть интегрированы в существующие интерфейсы.

Примеры использования и добавленная ценность

Сигналы API качества воздуха могут использоваться в различных поисковых системах, например, когда пользователи ищут место для посещения. API качества воздуха предлагает:

Данные в реальном времени * и исторические данные — свежие, точные данные, отражающие текущее состояние, а также данные за 30 дней с почасовым разрешением. (* почасовой снимок качества наружного воздуха)
Глобальные и локальные данные — охватывающие целые территории более чем в 100 странах, но при этом высоколокализованные (до 500 м) данные API о качестве воздуха предоставляют пользователям ключевые сигналы для сравнения и принятия решений о наиболее подходящем месте.

Качество воздуха может кардинально отличаться даже в близлежащих местах.

Пример пошагового руководства

Демонстрируйте данные о качестве воздуха на раннем этапе использования.

Существует два основных способа отображения данных API качества воздуха:

Текущие условия / почасовые значения : получить индивидуальные значения для отображения по каждому местоположению.
(Перейдите к разделу: Отображение данных API качества воздуха на метках местоположения )
Плитки тепловой карты : наложите на карту цветной слой, отображающий текущие условия качества наружного воздуха. Доступны индексы слоев для конкретных стран.
(Перейдите к разделу: Отображение слоя тепловой карты качества воздуха API на карте )

Отображение данных API о качестве воздуха на метках местоположения

Выберите индекс качества воздуха для вашего региона: универсальный индекс или местный индекс качества воздуха (доступно до 70 различных индексов качества воздуха ). Индекс качества воздуха (AQI) — это шкала, по которой определенная страна, например, Агентство по охране окружающей среды США (EPA ), классифицирует различные уровни качества воздуха на основе различных методов расчета, источников данных и целевых целей.
Начните визуализировать основные значения API качества воздуха и цветовую кодировку прямо из окна поиска мест.

По умолчанию может отображаться только цветовой код.

Отображение дополнительной информации об API качества воздуха при выборе метки:

Значение универсального индекса качества воздуха / локального индекса качества воздуха.
Уровни загрязняющих веществ , которые являются мерой количества частиц и газов в воздухе: преобладающий загрязнитель, концентрация, источники и воздействие.
Рекомендации по охране здоровья , представляющие собой рекомендуемые действия в условиях текущего качества воздуха.

Вы можете настроить уровень отображаемой по умолчанию информации в соответствии со своими потребностями. Имейте в виду, что данные по определенному местоположению часто полезны в сравнении с данными по другим местоположениям.

Пример отображения раздела «Качество воздуха»

Реагирование на загрязнение воздуха


{
    "dateTime": "2023-08-09T10:00:00Z",
    "regionCode": "fr",
    "indexes": [
       {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 76,
            "aqiDisplay": "76",
            "color": {
                "red": 0.4117647,
                "green": 0.77254903,
                "blue": 0.20392157
            },
            "category": "Good air quality",
            "dominantPollutant": "pm10"
        },
       …
    ],
    "pollutants": [
       {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 95.18,
                "units": "PARTS_PER_BILLION"
            }...
        },
       …
    ],
    "healthRecommendations": -{
        "generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
        "elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider red ...",
        "lungDiseasePopulation": …
    }
}

В качестве альтернативы, вы можете запрашивать данные о качестве воздуха только при взаимодействии с определенным местоположением.

Вы можете использовать индекс API качества воздуха для фильтрации близлежащих мест, например: если вы ищете парки в своем районе, вам будут показаны только парки с хорошим качеством воздуха.

Реагирование на загрязнение воздуха

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...

Преобразовать в RGB

  var red = parseInt(colorResponse.red*255)|| 1;
  var green = parseInt(colorResponse.green*255)|| 1;
  var blue = parseInt(colorResponse.blue*255)|| 1; 
  // --> output rgb(241,250,5)

Отобразить слой тепловой карты API качества воздуха на карте.

Цветные плитки на тепловой карте — отличный способ:

для предоставления общего обзора территории.
быстро продемонстрировать нюансы в этой области.

Используйте JavaScript API карт с типом карты ImateMapType для отображения отдельных фрагментов, необходимых для покрытия всей области просмотра вашей карты Google. Фрагменты тепловой карты будут обновляться по мере взаимодействия пользователя с картой (панорамирование, масштабирование или изменение местоположения).

Обратите внимание, что допустимое значение уровня масштабирования составляет до 16.
Слой тепловых карт качества воздуха API может исчезнуть при поиске по локальной сети.

В рамках ограниченного набора индексов качества воздуха можно выбрать различные типы тепловых карт :

UAQI_RED_GREEN — Красная и зеленая палитра Универсального индекса качества воздуха.

UAQI_INDIGO_PERSIAN - Универсальный индекс качества воздуха, палитра indigo-persian.

PM25_INDIGO_PERSIAN - PM2.5 индекс палитры indigo-persian.

GBR_DEFRA - Цветовая палитра ежедневного индекса качества воздуха (Великобритания).

DEU_UBA — цветовая палитра немецкого локального индекса качества воздуха.

CAN_EC — Цветовая палитра Канадского индекса качества воздуха для здоровья.

FRA_ATMO — цветовая палитра Индекса качества воздуха Франции.

US_AQI — цветовая палитра индекса качества воздуха в США.

Обязательно укажите цветовую шкалу, чтобы пользователи могли понять значение и его цветовой рейтинг:

Шкала градиента UAQI (0-100): Плохое / Отличное

Фрагмент кода CSS для цветовой палитры:

.gradient-scale { 
background: linear-gradient(to right, 
    rgb(99, 20, 161) 0%, /* purple */
    rgb(149, 0, 25) 20%, /* red */
    rgb(248, 47, 21) 40%, /* orange */
    rgb(255, 248, 35) 60%, /* yellow */
    rgb(34,163,120) 80%, /* steelblue */
    rgb(255,255,255) 100% /* white */
   );
}

Сплошные цвета для обозначения ключевых значений по шкале UAQI (0-100): Плохое / Отличное

Количество запросов и связанные с ними затраты

API JavaScript для работы с картами : 1 карта при загрузке приложения.
API качества воздуха :
- 1 запрос в каждом месте (все при загрузке карты или только при выборе пользователя).
- Слой тайлов тепловой карты: каждое изображение тайла имеет размер 256*256 пикселей, и для отображения стандартной карты на мобильном устройстве или в веб-версии требуется 12-14 тайлов. Каждый извлеченный тайл считается за 1 единицу SKU.
API поиска поблизости (новый) : отображается 1 запрос на каждые 20 мест. Разная стоимость в зависимости от данных о местах , содержащихся в ответе на запрос.

Заключение

Мы показали, что API качества воздуха может быть важным источником данных для пользователей при выборе места для посещения. Поэтому данные о качестве воздуха должны отображаться как можно раньше в процессе поиска, при этом необходимо учитывать объем отображаемой информации и способ ее представления.

Следующие действия

Рекомендуемая дополнительная литература:

Авторы

Данная статья поддерживается компанией Google. Ее первоначальный автор — следующие лица.
Основной автор:

Томас Англаре | Инженер по решениям