Weather - Get Current Air Quality

Służy do uzyskiwania aktualnych informacji o jakości powietrza, które obejmują potencjalne zagrożenia i sugerowane środki ostrożności.
Interfejs Get Current Air Quality API to żądanie HTTP GET , które zwraca szczegółowe informacje o stężeniu zanieczyszczeń i ogólnym stanie bieżącej jakości powietrza, w tym poziomy zanieczyszczeń, wartości indeksu jakości powietrza, dominujące zanieczyszczenie oraz krótkie oświadczenie podsumowujące poziom ryzyka i sugerowane środki ostrożności.

GET {endpoint}/weather/airQuality/current/json?api-version=1.1&query={query}

GET {endpoint}/weather/airQuality/current/json?api-version=1.1&language={language}&query={query}&pollutants={pollutants}

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

AadToken

Są to przepływy Microsoft Entra OAuth 2.0. W połączeniu z Azure zarządzaniem dostępem opartym na rolach może być używany do kontroli dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach Azure służy do wyznaczania dostępu do jednego lub więcej kont zasobów lub podzasobów Azure Maps. Każdy użytkownik, grupa lub jednostka usługi mogą mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do interfejsów API REST usługi Azure Maps.

Aby zaimplementować scenariusze, zalecamy wyświetlenie koncepcji uwierzytelniania . Podsumowując, ta definicja zabezpieczeń zawiera rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenie konta usługi Azure Maps w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsu API REST.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do całego interfejsu API REST. Innymi słowy, ten klucz może służyć jako klucz główny na koncie, w którym są wystawiane.

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie poufnych aplikacji klienckich podejście do uzyskiwania dostępu do interfejsów API REST usługi Azure Maps, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: header

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji List SAS na zasobie usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.

Dzięki temu tokenowi każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure i szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token SAS może służyć do umożliwienia aplikacjom kontrolowania dostępu w sposób bardziej zabezpieczony niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie Mapowanie konta w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SAS.

Typ: apiKey
W: header

Przykłady

Get Current Air Quality

GET https://atlas.microsoft.com/weather/airQuality/current/json?api-version=1.1&query=47.632346,-122.13887

{
  "results": [
    {
      "description": "The air quality is generally acceptable for most individuals. However, sensitive groups may experience minor to moderate symptoms from long-term exposure.",
      "category": "Fair",
      "categoryColor": "#FFC300",
      "dateTime": "2021-07-19T02:00:00+00:00",
      "dominantPollutant": "Ozone",
      "globalIndex": 22.1,
      "index": 21.6,
      "pollutants": [
        {
          "name": "Nitrogen Dioxide",
          "type": "NO2",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 13.4
          },
          "globalIndex": 6.7,
          "index": 6.7
        },
        {
          "name": "Ozone",
          "type": "O3",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 53.5
          },
          "globalIndex": 22.1,
          "index": 21.6
        },
        {
          "name": "Particulate Matter 10",
          "type": "PM10",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 12.2
          },
          "globalIndex": 12.2,
          "index": 11.3
        },
        {
          "name": "Particulate Matter 2.5",
          "type": "PM2.5",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 3.2
          },
          "globalIndex": 6.5,
          "index": 13.5
        },
        {
          "name": "Carbon Monoxide",
          "type": "CO",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 118.4
          },
          "globalIndex": 0.6,
          "index": 1.2
        },
        {
          "name": "Sulfur Dioxide",
          "type": "SO2",
          "concentration": {
            "unit": "µg/m³",
            "unitType": 31,
            "value": 1.1
          },
          "globalIndex": 1.1,
          "index": 0.6
        }
      ]
    }
  ]
}

Definicje

AirQuality

Aktualny odczyt jakości powietrza w jednym miejscu zwrócił się jako wpis w AirQualityResult.results. Łączy indeks jakości powietrza raportowany przez lokalny organ regulacyjny (index) z międzynarodowo znormalizowanym indeksem (globalIndex), identyfikuje czynnik dominantPollutant wyniku, a następnie łączy je z lokalnym jakościowym category wskaźnikiem oraz dopasowaniem categoryColor odpowiednim do kolorowego interfejsu. Krótka wersja description wyjaśnia, co odczyt oznacza dla codziennych czynności i wszelkich środków ostrożności zdrowotnych, a gdy żąda się szczegółów dotyczących zanieczyszczeń, tablica pollutants zawiera rozkład na poszczególne zanieczyszczenia.

AirQualityResult

Odpowiedź otrzymała operacja Get Current Air Quality, która podała aktualne warunki jakości powietrza w określonym miejscu. Tablica results zawiera pojedynczy AirQuality wpis podsumowujący lokalne i globalnie znormalizowane wskaźniki jakości powietrza, dominujący zanieczyszczenia, kategorię jakościową i pasujący kolor, krótki opis implikacji zdrowotnych oraz (na żądanie) szczegóły dotyczące poszczególnych zanieczyszczeń.

DominantPollutant

Identyfikuje zanieczyszczenie o najwyższym stężeniu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

JsonFormat

Żądany format odpowiedzi. Obsługiwany jest tylko format json.

Pollutant

Pojedynczy zanieczyszczenie zmierzony w zapytanej lokalizacji zwracał jako jeden wpis w AirQuality.pollutants. Każdy wpis identyfikuje zanieczyszczenie (kodem i nazwą angielską), raportuje jego pomiar concentration w powietrzu oraz podaje indywidualny wkład zanieczyszczenia do lokalnego AQI (index) i międzynarodowo znormalizowanego indeksu (globalIndex) – tych samych dwóch skal raportowanych przy ogólnym odczytie na , AirQualityale ograniczonych do tego zanieczyszczenia. Typowy odczyt jakości powietrza zawiera jeden wpis na każdy zanieczyszczenie – dwutlenek azotu, ozon, cząstki 10, cząstki 2.5, tlenek węgla i dwutlenek siarki – dzięki czemu dzwoniący mogą zobaczyć, które substancje są obecne i ile każda z nich wnosi.

PollutantType

Opis sześciu typów zanieczyszczeń śledzonych przez usługę pogodową Azure Maps.

UnitType

Wartość całkowita przypisana do typu wyświetlanej jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.

WeatherValue

Wartości dla wskaźników związanych z pogodą, takich jak temperatura, punkt rosy i prędkość wiatru, przedstawione w jednostkach metrycznych lub imperialnych, zgodnie z parametrem jednostkowym URI. Więcej informacji można znaleźć w artykule Typy jednostek w artykule Weather services in Azure Maps.