次の方法で共有


Weather - Get Air Quality Hourly Forecasts

汚染物質レベル、潜在的なリスク、推奨される予防措置を含む、次の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

Azure Maps API のバージョン番号。

query
query True

number[]

緯度の後に経度 (例: "47.641268,-122.125679" など) で構成されるコンマ区切り文字列として指定された該当するクエリ。

duration
query

HourlyDuration

int32

空気の品質について知りたい時間数を指定します。 使用可能な値は、1、12、24、48、72、96 です。 既定値は 1 時間です。

language
query

string

検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。

詳細については、「 サポートされている言語 」を参照してください。

pollutants
query

boolean

各汚染物質に関する詳細情報を返すブール値。 既定では True です。

要求ヘッダー

名前 必須 説明
x-ms-client-id

string

Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーン アカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンスについては、次 の記事を 参照してください。

応答

名前 説明
200 OK

AirQualityResult

OK

Other Status Codes

ErrorResponse

予期しないエラーが発生しました。

セキュリティ

AADToken

これらは Microsoft Entra OAuth 2.0 フローです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上の Azure Maps リソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。

シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

メモ

  • このセキュリティ定義 では 、 ヘッダーを x-ms-client-id 使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す必要があります。 これは、 Maps 管理 API から取得できます。

Authorization URLは、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、一意の承認 URL と Microsoft Entra ID 構成があります。 * Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーン から構成されます。 * Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。

型: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

これは、Azure portal で Azure Maps アカウントを作成 するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。

公開されているアプリケーションの場合、キーを安全に格納できるように 、機密クライアント アプリケーション のアプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーンを介して Azure Maps リソース の SAS の一覧表示操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

型: apiKey
/: header

Get Hourly Air Quality Forecasts

Sample request

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

Sample response

{
  "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

個々の汚染物質に関する詳細情報。 =false の場合 pollutantsは返されません。

PollutantType

汚染物質の種類。 随時追加される場合がありますのでご注意ください。

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

WeatherUnit

天気に関連する特定の単位の特定の値。

AirQuality

特定の時刻における特定の場所の大気質に関する情報。

名前 説明
category

string

要求された言語での大気質の 1 単語の説明。 たとえば、"Excellent" などです。

categoryColor

string

この空気質の結果のカテゴリに対応する一意の色。

dateTime

string

ISO 8601 形式で表示されている現在の観測値の日付と時刻 (例: 2019-10-27T19:39:57-08:00)。

description

string

この大気質のテキストによる説明は、要求された言語になります。

dominantPollutant

DominantPollutant

最も高い濃度の汚染物質。

globalIndex

number

0 ~ 300 以上のスケールで国際的に正規化された大気質評価。数値が高いほど、空気の質が悪くなります。

index

number

ローカル規制機関によるスケール セットの大気質評価。 スケールは場所によって大きく異なる場合があります。 詳細については 、Wikipedia を参照してください。

pollutants

Pollutant[]

個々の汚染物質に関する情報。

AirQualityResult

このオブジェクトは、成功した Get Air Quality 呼び出しから返されます。

名前 説明
nextLink

string

は、返される機能の次のページへのリンクです。 最後のページの場合は、このフィールドはありません。

results

AirQuality[]

クエリ対象の場所のすべての大気質の結果の一覧。

DominantPollutant

汚染物質の種類。 随時追加される場合がありますのでご注意ください。

名前 説明
Carbon Monoxide

string

一酸化炭素 ("CO")

Nitrogen Dioxide

string

二酸化窒素 ("NO2")

Ozone

string

Zone ("O3")

Particulate Matter 10

string

粒子状物質 10 ("PM10")

Particulate Matter 2.5

string

粒子状物質 2.5 ("PM2.5")

Sulfur Dioxide

string

二酸化硫黄 ("SO2")

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

HourlyDuration

大気の質について知りたい時間数を指定します。 使用できる値は、1、12、24、48、72、96 です。 既定値は 1 時間です。

名前 説明
1

string

12

string

24

string

48

string

72

string

96

string

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

名前 説明
json

string

JavaScript オブジェクト表記データ交換形式

Pollutant

個々の汚染物質に関する詳細情報。 =false の場合 pollutantsは返されません。

名前 説明
concentration

WeatherUnit

空気の体積あたりの汚染物質粒子の数を含むオブジェクト。

globalIndex

number

0 ~ 300 以上のスケールで国際的に正規化された大気質評価。数値が高いほど、空気の質が悪くなります。

index

number

ローカル規制機関によるスケール セットの大気質評価。 スケールは場所によって大きく異なる場合があります。 詳細については 、Wikipedia を参照してください。

name

string

英語の汚染物質の名前。

type

PollutantType

汚染物質の種類。 随時追加される場合がありますのでご注意ください。

PollutantType

汚染物質の種類。 随時追加される場合がありますのでご注意ください。

名前 説明
CO

string

一酸化炭素 ("CO")

NO2

string

二酸化窒素 ("NO2")

O3

string

Zone ("O3")

PM10

string

粒子状物質 10 ("PM10")

PM2.5

string

粒子状物質 2.5 ("PM2.5")

SO2

string

二酸化硫黄 ("SO2")

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

名前 説明
0

Integer

1

Integer

10

Integer

11

Integer

12

Integer

13

Integer

14

Integer

15

Integer

16

Integer

17

Integer

18

Integer

19

Integer

2

Integer

20

Integer

21

Integer

22

Integer

3

Integer

31

Integer

4

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

WeatherUnit

天気に関連する特定の単位の特定の値。

名前 説明
unit

string

戻り値の単位の型。

unitType

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

value

number

丸められた値。