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

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

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

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

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

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

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

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

Показывайте данные о качестве воздуха на ранних этапах

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

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

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

Выберите индекс качества воздуха для вашего местоположения: универсальный или локальный (доступно до 70 различных индексов качества воздуха ). Индекс качества воздуха (ИКВ) — это шкала, по которой определённая страна, например, Агентство по охране окружающей среды США , классифицирует различные уровни качества воздуха на основе различных методов расчёта, источников данных и целей.
Начните визуализировать основное значение 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 качества воздуха на карте

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

для обеспечения обзора большой территории.
чтобы быстро показать нюансы в этой области.

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

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

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

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

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

PM25_INDIGO_PERSIAN - индигово-персидская палитра с индексом PM2.5.

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): плохо / отлично

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

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

Заключение

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

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

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

Авторы

Эта статья поддерживается Google. Её авторами являются следующие авторы:
Основной автор:

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