Weather - Get Air Quality Hourly Forecasts

Ссылка

Служба:: Maps

Версия API:: 1.1

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

Get Air Quality Hourly Forecasts API представляет собой HTTP-запросGET, который возвращает подробную информацию о концентрации загрязняющих веществ и общем состоянии прогнозируемого предстоящего почасового качества воздуха. Сервис может предоставлять прогнозируемую почасовую информацию о качестве воздуха на предстоящие периоды времени 1, 12, 24, 48, 72 и 96 часов, включая уровни загрязнения, значения индекса качества воздуха, доминирующий загрязнитель, а также краткое заявление, обобщающее уровень риска и предлагаемые меры предосторожности.

GET https://atlas.microsoft.com/weather/airQuality/forecasts/hourly/json?api-version=1.1&query={query}

С использованием необязательных параметров:

GET https://atlas.microsoft.com/weather/airQuality/forecasts/hourly/json?api-version=1.1&language={language}&query={query}&duration={duration}&pollutants={pollutants}

Параметры URI

Имя	В	Обязательно	Тип	Описание
format	path	True	JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
api-version	query	True	string	Номер версии API Azure Maps.
query	query	True	number[]	Применимый запрос, указанный как разделенная запятыми строка, состоящая из широты, за которой следует долгота, например "47.641268,-125679". Информация о погоде обычно доступна для мест на суше, водоемов, окруженных сушей, и районов океана, которые находятся в пределах примерно 50 морских миль от береговой линии.
duration	query		HourlyDuration (int32)	Указывает, в течение скольких часов мы хотели бы знать о качестве воздуха. Доступные значения: 1, 12, 24, 48, 72, 96. Значение по умолчанию — 1 час.
language	query		string	Язык, в котором должны быть возвращены результаты поиска. Должен быть одним из поддерживаемых тегов языка IETF, не учитывает регистр. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию. Дополнительные сведения см. в поддерживаемых языках.
pollutants	query		boolean	Логическое значение, которое возвращает подробную информацию о каждом загрязнителе. По умолчанию установлено значение True.

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности идентификатора Microsoft Entra. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Сведения о том, как использовать безопасность идентификатора Microsoft Entra в Azure Maps, см. в следующих статьях .

Ответы

Имя	Тип	Описание
200 OK	AirQualityResult	ХОРОШО
Other Status Codes	ErrorResponse	Произошла непредвиденная ошибка.

Безопасность

AADToken

Это потоки Microsoft Entra OAuth 2.0. При паре с доступом на основе ролей Azure его можно использовать для управления доступом к REST API Azure Maps. Управление доступом на основе ролей Azure используется для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Доступ к любому пользователю, группе или субъекту-службе можно предоставить через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.

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

Примечания.

Для этого определения безопасности требуется использовать заголовок x-ms-client-id, чтобы указать, к какой ресурсу Azure Maps приложение запрашивает доступ. Это можно получить из API управления карт.

Authorization URL зависит от экземпляра общедоступного облака Azure. В национальных облаках есть уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra. * Управление доступом на основе ролей Azure настраивается с плоскости управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API. * Использование веб-пакета SDK Azure Maps позволяет настроить приложение на основе конфигурации для нескольких вариантов использования.

Дополнительные сведения о платформе удостоверений Майкрософт см. в обзоре платформы удостоверений Майкрософт.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, подготовленный при создания учетной записи Azure Maps на портале Azure или с помощью PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого ключа любой приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве главного ключа в учетной записи, в которую они выданы.

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

Тип: apiKey
В: query

SAS Token

Это маркер подписанного URL-адреса создается из операции SAS списка на ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого маркера любой приложению разрешен доступ с помощью управления доступом на основе ролей Azure и точного управления сроком действия, скоростью и регионами, используемыми для конкретного маркера. Другими словами, маркер SAS можно использовать для разрешения приложений управлять доступом более защищенным способом, чем общий ключ.

Для общедоступных приложений мы рекомендуем настроить определенный список разрешенных источников в ресурсе учетной записи карты карты, чтобы ограничить злоупотребление отрисовкой и регулярно обновлять маркер SAS.

Тип: apiKey
В: header

Примеры

Get Hourly Air Quality Forecasts

Образец запроса

HTTP

GET https://atlas.microsoft.com/weather/airQuality/forecasts/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Пример ответа

Код состояния:: 200

{
  "results": [
    {
      "dateTime": "2021-07-19T04:00:00+00:00",
      "index": 20.1,
      "globalIndex": 19.9,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 7.5,
          "globalIndex": 7.5,
          "concentration": {
            "value": 14.9,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 20.1,
          "globalIndex": 19.9,
          "concentration": {
            "value": 49.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 11.6,
          "globalIndex": 12.6,
          "concentration": {
            "value": 12.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.3,
          "globalIndex": 6.9,
          "concentration": {
            "value": 3.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.2,
          "globalIndex": 0.6,
          "concentration": {
            "value": 125.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.6,
          "globalIndex": 1.2,
          "concentration": {
            "value": 1.2,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T05:00:00+00:00",
      "index": 19.2,
      "globalIndex": 19.1,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 7.8,
          "globalIndex": 7.7,
          "concentration": {
            "value": 15.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 19.2,
          "globalIndex": 19.1,
          "concentration": {
            "value": 47.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 11.9,
          "globalIndex": 12.8,
          "concentration": {
            "value": 12.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.9,
          "globalIndex": 7.1,
          "concentration": {
            "value": 3.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.4,
          "globalIndex": 0.7,
          "concentration": {
            "value": 143.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.7,
          "globalIndex": 1.3,
          "concentration": {
            "value": 1.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T06:00:00+00:00",
      "index": 18.3,
      "globalIndex": 18.2,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8,
          "globalIndex": 8,
          "concentration": {
            "value": 16,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 18.3,
          "globalIndex": 18.2,
          "concentration": {
            "value": 45.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.1,
          "globalIndex": 13.1,
          "concentration": {
            "value": 13.1,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 15.4,
          "globalIndex": 7.4,
          "concentration": {
            "value": 3.7,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.6,
          "globalIndex": 0.8,
          "concentration": {
            "value": 162.1,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.4,
          "concentration": {
            "value": 1.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T07:00:00+00:00",
      "index": 17.5,
      "globalIndex": 17.3,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.3,
          "globalIndex": 8.3,
          "concentration": {
            "value": 16.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 17.5,
          "globalIndex": 17.3,
          "concentration": {
            "value": 43.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.4,
          "globalIndex": 13.4,
          "concentration": {
            "value": 13.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 16,
          "globalIndex": 7.7,
          "concentration": {
            "value": 3.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 180.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.5,
          "concentration": {
            "value": 1.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T08:00:00+00:00",
      "index": 16.9,
      "globalIndex": 16.8,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.2,
          "globalIndex": 8.2,
          "concentration": {
            "value": 16.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 16.9,
          "globalIndex": 16.8,
          "concentration": {
            "value": 42,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.4,
          "globalIndex": 13.3,
          "concentration": {
            "value": 13.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 15.4,
          "globalIndex": 7.4,
          "concentration": {
            "value": 3.7,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 180.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.9,
          "globalIndex": 1.6,
          "concentration": {
            "value": 1.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T09:00:00+00:00",
      "index": 16.4,
      "globalIndex": 16.3,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.1,
          "globalIndex": 8.1,
          "concentration": {
            "value": 16.2,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 16.4,
          "globalIndex": 16.3,
          "concentration": {
            "value": 40.7,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.3,
          "globalIndex": 13.3,
          "concentration": {
            "value": 13.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.8,
          "globalIndex": 7.1,
          "concentration": {
            "value": 3.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 181.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.9,
          "globalIndex": 1.6,
          "concentration": {
            "value": 1.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T10:00:00+00:00",
      "index": 15.9,
      "globalIndex": 15.7,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.1,
          "globalIndex": 8,
          "concentration": {
            "value": 16.1,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 15.9,
          "globalIndex": 15.7,
          "concentration": {
            "value": 39.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.3,
          "globalIndex": 13.3,
          "concentration": {
            "value": 13.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.2,
          "globalIndex": 6.8,
          "concentration": {
            "value": 3.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 181.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.9,
          "globalIndex": 1.6,
          "concentration": {
            "value": 1.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T11:00:00+00:00",
      "index": 15.8,
      "globalIndex": 15.7,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.1,
          "globalIndex": 8.1,
          "concentration": {
            "value": 16.2,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 15.8,
          "globalIndex": 15.7,
          "concentration": {
            "value": 39.2,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 12.8,
          "globalIndex": 13.8,
          "concentration": {
            "value": 13.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.5,
          "globalIndex": 6.9,
          "concentration": {
            "value": 3.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 179.1,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.6,
          "concentration": {
            "value": 1.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T12:00:00+00:00",
      "index": 15.7,
      "globalIndex": 15.6,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.2,
          "globalIndex": 8.1,
          "concentration": {
            "value": 16.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 15.7,
          "globalIndex": 15.6,
          "concentration": {
            "value": 39,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 13.3,
          "globalIndex": 14.3,
          "concentration": {
            "value": 14.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.7,
          "globalIndex": 7.1,
          "concentration": {
            "value": 3.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.8,
          "globalIndex": 0.9,
          "concentration": {
            "value": 176.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.5,
          "concentration": {
            "value": 1.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T13:00:00+00:00",
      "index": 15.7,
      "globalIndex": 15.5,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 8.2,
          "globalIndex": 8.2,
          "concentration": {
            "value": 16.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 15.7,
          "globalIndex": 15.5,
          "concentration": {
            "value": 38.9,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 13.7,
          "globalIndex": 14.8,
          "concentration": {
            "value": 14.8,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 15,
          "globalIndex": 7.2,
          "concentration": {
            "value": 3.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.7,
          "globalIndex": 0.9,
          "concentration": {
            "value": 173.7,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.5,
          "concentration": {
            "value": 1.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T14:00:00+00:00",
      "index": 18.7,
      "globalIndex": 18.6,
      "dominantPollutant": "Ozone",
      "category": "Excellent",
      "categoryColor": "#00E39B",
      "description": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 7.7,
          "globalIndex": 7.7,
          "concentration": {
            "value": 15.4,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 18.7,
          "globalIndex": 18.6,
          "concentration": {
            "value": 46.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 13.8,
          "globalIndex": 14.9,
          "concentration": {
            "value": 14.9,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.7,
          "globalIndex": 7.1,
          "concentration": {
            "value": 3.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.6,
          "globalIndex": 0.8,
          "concentration": {
            "value": 165.3,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.5,
          "concentration": {
            "value": 1.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    },
    {
      "dateTime": "2021-07-19T15:00:00+00:00",
      "index": 21.8,
      "globalIndex": 22.4,
      "dominantPollutant": "Ozone",
      "category": "Fair",
      "categoryColor": "#FFC300",
      "description": "The air quality is generally acceptable for most individuals. However, sensitive groups may experience minor to moderate symptoms from long-term exposure.",
      "pollutants": [
        {
          "type": "NO2",
          "name": "Nitrogen Dioxide",
          "index": 7.3,
          "globalIndex": 7.2,
          "concentration": {
            "value": 14.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "O3",
          "name": "Ozone",
          "index": 21.8,
          "globalIndex": 22.4,
          "concentration": {
            "value": 54.1,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM10",
          "name": "Particulate Matter 10",
          "index": 13.9,
          "globalIndex": 15,
          "concentration": {
            "value": 15,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "PM2.5",
          "name": "Particulate Matter 2.5",
          "index": 14.5,
          "globalIndex": 6.9,
          "concentration": {
            "value": 3.5,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "CO",
          "name": "Carbon Monoxide",
          "index": 1.6,
          "globalIndex": 0.8,
          "concentration": {
            "value": 157,
            "unit": "µg/m³",
            "unitType": 31
          }
        },
        {
          "type": "SO2",
          "name": "Sulfur Dioxide",
          "index": 0.8,
          "globalIndex": 1.6,
          "concentration": {
            "value": 1.6,
            "unit": "µg/m³",
            "unitType": 31
          }
        }
      ]
    }
  ]
}

Определения

Имя	Описание
AirQuality	Информация о качестве воздуха в конкретном месте в определенное время.
AirQualityResult	Этот объект возвращается в результате успешного вызова Get Air Quality.
DominantPollutant	Вид загрязняющего вещества. Обратите внимание, что в любое время могут быть добавлены дополнительные данные.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
HourlyDuration	Указывает, в течение скольких часов мы хотели бы знать о качестве воздуха. Доступные значения: 1, 12, 24, 48, 72, 96. Значение по умолчанию — 1 час.
JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
Pollutant	Подробная информация об отдельном загрязнителе. Не возвращается, если `pollutants`=false.
PollutantType	Вид загрязняющего вещества. Обратите внимание, что в любое время могут быть добавлены дополнительные данные.
UnitType	Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
WeatherUnit	Удельное значение данной единицы, связанное с погодой.

AirQuality

Object

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

Имя	Тип	Описание
category	string	Описание качества воздуха в одном слове на запрашиваемом языке. Например, «Отлично».
categoryColor	string	Уникальный цвет, соответствующий категории данного результата по качеству воздуха.
dateTime	string (date-time)	Дата и время текущего наблюдения отображаются в формате ISO 8601, например, 2019-10-27T19:39:57-08:00.
description	string	Текстовое объяснение этого качества воздуха на требуемом языке.
dominantPollutant	DominantPollutant	Загрязнитель с самой высокой концентрацией.
globalIndex	number (float)	Международно нормализованный рейтинг качества воздуха по шкале от 0 до 300 и выше, где более высокие цифры означают худшее качество воздуха.
index	number (float)	Оценка качества воздуха по шкале, установленной местными регулирующими органами. Масштабы могут сильно различаться в зависимости от местоположения. Смотрите Википедию для получения дополнительной информации.
pollutants	Pollutant[]	Информация об отдельных загрязнителях.

AirQualityResult

Object

Этот объект возвращается в результате успешного вызова Get Air Quality.

Имя	Тип	Описание
nextLink	string	Ссылка на следующую страницу возвращаемых функций. Если это последняя страница, это поле не отображается.
results	AirQuality[]	Список всех результатов по качеству воздуха для запрашиваемого местоположения.

DominantPollutant

Перечисление

Вид загрязняющего вещества. Обратите внимание, что в любое время могут быть добавлены дополнительные данные.

Значение	Описание
Carbon Monoxide	Окись углерода («CO»)
Nitrogen Dioxide	Диоксид азота («NO2»)
Ozone	Озон («O3»)
Particulate Matter 10	Твердые частицы 10 ("PM10")
Particulate Matter 2.5	Твердые частицы 2,5 ("PM2,5")
Sulfur Dioxide	Диоксид серы («SO2»)

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

HourlyDuration

Перечисление

Указывает, в течение скольких часов мы хотели бы знать о качестве воздуха. Доступные значения: 1, 12, 24, 48, 72, 96. Значение по умолчанию — 1 час.

Значение	Описание
1	1 ч.
12	12 часов
24	24 часа
48	48 часов
72	72 часа
96	96 часов

JsonFormat

Перечисление

Требуемый формат ответа. Поддерживается только json формат.

Значение	Описание
json	формат обмена данными для объектов JavaScript

Pollutant

Object

Подробная информация об отдельном загрязнителе. Не возвращается, если pollutants=false.

Имя	Тип	Описание
concentration	WeatherUnit	Объект, содержащий количество загрязняющих частиц на объем воздуха.
globalIndex	number (float)	Международно нормализованный рейтинг качества воздуха по шкале от 0 до 300 и выше, где более высокие цифры означают худшее качество воздуха.
index	number (float)	Оценка качества воздуха по шкале, установленной местными регулирующими органами. Масштабы могут сильно различаться в зависимости от местоположения. Смотрите Википедию для получения дополнительной информации.
name	string	Название загрязнителя на английском языке.
type	PollutantType	Вид загрязняющего вещества. Обратите внимание, что в любое время могут быть добавлены дополнительные данные.

PollutantType

Перечисление

Вид загрязняющего вещества. Обратите внимание, что в любое время могут быть добавлены дополнительные данные.

Значение	Описание
CO	Окись углерода («CO»)
NO2	Диоксид азота («NO2»)
O3	Озон («O3»)
PM10	Твердые частицы 10 ("PM10")
PM2.5	Твердые частицы 2,5 ("PM2,5")
SO2	Диоксид серы («SO2»)

UnitType

Перечисление

Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .

Значение	Описание
0	футы
1	дюймы
10	метры в секунду (м/с)
11	гектопаскали
12	дюймы ртутного столба
13	килопаскали
14	миллибары
15	миллиметры ртутного столба (мм рт. столба)
16	poundsPerSquareInch (фунт/кв. дюйм)
17	Цельсия
18	Фаренгейт
19	Кельвин
2	мили
20	процент
21	плавать
22	целое число
3	миллиметр
31	МикрограммКубический метр воздуха
4	сантиметр
5	метр
6	километр
7	километры в час (км/час)
8	узлы
9	миль в час

WeatherUnit

Object

Удельное значение данной единицы, связанное с погодой.

Имя	Тип	Описание
unit	string	Тип единицы измерения для возвращаемого значения.
unitType	UnitType (int32)	Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
value	number (float)	Округленное значение.

Поделиться через

Weather - Get Air Quality Hourly Forecasts

Параметры URI

Заголовок запроса

Ответы

Безопасность

AADToken

Примечания.

Области

subscription-key

SAS Token

Примеры

Get Hourly Air Quality Forecasts

Образец запроса

Пример ответа

Определения

AirQuality

AirQualityResult

DominantPollutant

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HourlyDuration

JsonFormat

Pollutant

PollutantType

UnitType

WeatherUnit