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

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

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

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

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

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

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

Пример прохождения

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

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

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

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

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

Дисплей по умолчанию может включать только цветовой код.

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

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

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

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

Реакция на качество воздуха


{
    "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 качества воздуха на карте

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

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

Используйте Maps JavaScript API с 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): Плохо/Отлично.

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

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

Заключение

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

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

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

Авторы

Google поддерживает эту статью. Первоначально его написали следующие участники.
Основной автор:

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