Airly (独立した発行元)
Airly は、コミュニティの大気汚染に関する正確でハイパーローカルなデータを提供します。 これは、健康リスクを理解し、改善を行う最初のステップです。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| tomasz@poszytek.eu |
| コネクタ メタデータ | |
|---|---|
| Publisher | Tomasz Poszytek |
| Web サイト | https://airly.org/ |
| プライバシー ポリシー | https://airly.org/en/terms-conditions/ |
| カテゴリ | モノのインターネット;ライフスタイルとエンターテイメント |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ID でインストールを取得する |
操作は、InstallationId によって指定された 1 つのインストール メタデータを返します。 |
| インストールの測定値を取得する |
エンドポイントは、InstallationId によって指定された具象インストールの測定値を返します。 |
| ポイントの測定値を取得する |
エンドポイントは、任意の地理的な場所の測定値を返します。 測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 戻り値は加重平均であり、重みはセンサーから指定されたポイントまでの距離に反比例します。 |
| 使用可能なインデックスを取得する |
エンドポイントは、API でサポートされているすべてのインデックスの種類の一覧と、各インデックスの種類ごとに定義されたレベルのリストを返します。 |
| 使用可能な測定値を取得する |
エンドポイントは、API でサポートされているすべての測定の種類とその名前と単位の一覧を返します。 |
| 最も近いインストールを取得する |
エンドポイントは、特定のポイントに最も近いインストールの一覧を、そのポイントまでの距離で並べ替えて返します。 |
| 最も近い測定値を取得する |
エンドポイントは、特定の場所に最も近いインストールの測定値を返します。 |
ID でインストールを取得する
操作は、InstallationId によって指定された 1 つのインストール メタデータを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インストール ID
|
InstallationID | True | integer |
メタデータを取得する単一インストールの ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
ID (アイディー)
|
id | integer |
一意のインストール識別子。 InstallationId を使用すると、特定のインストールからの測定値を照会できます。 |
|
緯度
|
location.latitude | float |
インストール座標 - 緯度。 地図上の正確なセンサー位置。 |
|
緯度
|
location.longitude | float |
インストール座標 - 経度。 地図上の正確なセンサー位置。 |
|
場所 ID
|
locationId | integer |
一意の場所識別子。 |
|
Country
|
address.country | string |
インストール国。 属性は省略可能で、空または null の場合があります。 |
|
市区町村
|
address.city | string |
インストール市区町村。 属性は省略可能で、空または null の場合があります。 |
|
Street
|
address.street | string |
インストールストリート。 属性は省略可能で、空または null の場合があります。 |
|
Number
|
address.number | string |
インストールの番地。 属性は省略可能で、空または null の場合があります。 |
|
表示アドレス 1
|
address.displayAddress1 | string |
学校名や番号など、住所を記述する追加のフィールド。 省略可能なフィールド。 |
|
表示アドレス 2
|
address.displayAddress2 | string |
学校名や番号など、住所を記述する追加のフィールド。 省略可能なフィールド。 |
|
Elevation
|
elevation | float |
デバイスがインストールされている高度。平均海面 (mamsl) の上のメートル。 |
|
Airly
|
airly | boolean |
このインストールが Airly デバイスかどうかを示すフラグ。たとえば、GIOŚ ステーションには false のフラグが設定されます。 |
|
ID (アイディー)
|
sponsor.id | integer |
スポンサー識別子。 |
|
名前
|
sponsor.name | string |
このインストールのスポンサーの名前。 |
|
Description
|
sponsor.description | string |
このインストールのスポンサーの追加の説明。 |
|
Logo
|
sponsor.logo | string |
スポンサーのロゴを指す URL (jpg 画像)。 |
|
Link
|
sponsor.link | string |
スポンサーの Web サイトを指す URL。 |
インストールの測定値を取得する
エンドポイントは、InstallationId によって指定された具象インストールの測定値を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インストール ID
|
installationId | True | integer |
測定値が返されるインストール識別子。 |
|
Language
|
Accept-Language | string |
テキストの説明を返す言語。 |
|
|
インデックスの種類
|
indexType | string |
計算して応答で返すインデックスの種類を選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DateTime から - 現在
|
current.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - current
|
current.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
current.indexes | array of object |
インデックス - 現在。 |
|
インデックス名 - 現在
|
current.indexes.name | string |
インデックスの名前 (CAQI、PIJP など)。 |
|
インデックス値 - 現在
|
current.indexes.value | float |
計算されたインデックスの数値。 |
|
レベル - 現在
|
current.indexes.level | string |
インデックスの目立たないレベル (HIGH、LOW など)。 |
|
説明 - 現在
|
current.indexes.description | string |
インデックス レベルの説明。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
アドバイス - 現在
|
current.indexes.advice | string |
現在のインデックス レベルに関するアドバイスを含む追加のテキスト。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
色 - 現在
|
current.indexes.color | string |
インデックス レベルを 16 進数の RGB トリプレット (例: #D1CF1E) で表す色。 |
|
standards
|
current.standards | array of object |
標準 - 最新。 |
|
標準名 - 現在
|
current.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 電流
|
current.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 現在
|
current.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 現在
|
current.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 現在
|
current.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
履歴
|
history | array of object |
履歴エントリ。 |
|
DateTime から - 履歴
|
history.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - 履歴
|
history.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
history.indexes | array of object |
インデックス - 履歴。 |
|
標準名 - 履歴
|
history.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
history.standards | array of object |
標準 - 履歴。 |
|
標準名 - 履歴
|
history.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
予測
|
forecast | array of object |
予測エントリ。 |
|
DateTime から - 予測
|
forecast.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
DateTime まで - 予測
|
forecast.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
forecast.values | array of object |
値 - 予測。 |
|
測定名 - 予測
|
forecast.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 予測
|
forecast.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
forecast.indexes | array of object |
インデックス - 予測。 |
|
標準名 - 予測
|
forecast.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
forecast.standards | array of object |
標準 - 予測。 |
|
標準名 - 予測
|
forecast.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
ポイントの測定値を取得する
エンドポイントは、任意の地理的な場所の測定値を返します。 測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 戻り値は加重平均であり、重みはセンサーから指定されたポイントまでの距離に反比例します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | number |
10 進度の緯度 (例: 50.062006)。 |
|
緯度
|
lng | True | number |
10 進度の経度 (例: 19.940984)。 |
|
インデックスの種類
|
indexType | string |
計算して応答で返すインデックスの種類を選択します。 |
|
|
Language
|
Accept-Language | string |
テキストの説明を返す言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DateTime から - 現在
|
current.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - current
|
current.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
current.indexes | array of object |
インデックス - 現在。 |
|
インデックス名 - 現在
|
current.indexes.name | string |
インデックスの名前 (CAQI、PIJP など)。 |
|
インデックス値 - 現在
|
current.indexes.value | float |
計算されたインデックスの数値。 |
|
レベル - 現在
|
current.indexes.level | string |
インデックスの目立たないレベル (HIGH、LOW など)。 |
|
説明 - 現在
|
current.indexes.description | string |
インデックス レベルの説明。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
アドバイス - 現在
|
current.indexes.advice | string |
現在のインデックス レベルに関するアドバイスを含む追加のテキスト。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
色 - 現在
|
current.indexes.color | string |
インデックス レベルを 16 進数の RGB トリプレット (例: #D1CF1E) で表す色。 |
|
standards
|
current.standards | array of object |
標準 - 最新。 |
|
標準名 - 現在
|
current.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 電流
|
current.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 現在
|
current.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 現在
|
current.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 現在
|
current.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
履歴
|
history | array of object |
履歴エントリ。 |
|
DateTime から - 履歴
|
history.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - 履歴
|
history.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
history.indexes | array of object |
インデックス - 履歴。 |
|
標準名 - 履歴
|
history.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
history.standards | array of object |
標準 - 履歴。 |
|
標準名 - 履歴
|
history.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
予測
|
forecast | array of object |
予測エントリ。 |
|
DateTime から - 予測
|
forecast.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
DateTime まで - 予測
|
forecast.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
forecast.values | array of object |
値 - 予測。 |
|
測定名 - 予測
|
forecast.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 予測
|
forecast.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
forecast.indexes | array of object |
インデックス - 予測。 |
|
標準名 - 予測
|
forecast.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
forecast.standards | array of object |
標準 - 予測。 |
|
標準名 - 予測
|
forecast.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
使用可能なインデックスを取得する
エンドポイントは、API でサポートされているすべてのインデックスの種類の一覧と、各インデックスの種類ごとに定義されたレベルのリストを返します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
インデックス名
|
name | string |
インデックス名。 |
|
レベル
|
levels | array of object |
使用可能なインデックス レベルの一覧。 |
|
最小値
|
levels.minValue | float |
指定されたレベルに対してインデックスが返すことができる最小値。 |
|
最大値
|
levels.maxValue | float |
指定されたレベルに対してインデックスが返すことができる最大値。 |
|
価値観
|
levels.values | string |
指定されたレベルに対してインデックスが返すことができる値。 |
|
レベル名
|
levels.level | string | |
|
レベルの説明
|
levels.description | string | |
|
色
|
levels.color | string |
インデックス レベルを 16 進数の RGB トリプレット (例: #D1CF1E) で表す色。 |
使用可能な測定値を取得する
エンドポイントは、API でサポートされているすべての測定の種類とその名前と単位の一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Language
|
Accept-Language | string |
テキストの説明を返す言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
名前
|
name | string |
この測定タイプの名前 (例: PM10)。 |
|
ラベル
|
label | string |
この測定タイプのわかりやすい名前 (フィールド変換)。 |
|
単位
|
unit | string |
この測定タイプの単位 (例: μg/m3)。 |
最も近いインストールを取得する
エンドポイントは、特定のポイントに最も近いインストールの一覧を、そのポイントまでの距離で並べ替えて返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | float |
10 進度の緯度 (例: 50.062006)。 |
|
緯度
|
lng | True | float |
10 進度の経度 (例: 19.940984)。 |
|
最大距離 (KM)
|
maxDistanceKM | float |
既定値は 3.0 です。 返されるすべてのインストールは、指定されたポイント (km 単位) からこの制限内に配置する必要があります。 負の値は制限がないことを意味します。 |
|
|
返された結果の最大数
|
maxResults | integer |
既定値は 1 です。 返されるインストールの最大数。 負の値は制限がないことを意味します |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
ID (アイディー)
|
id | integer |
一意のインストール識別子。 InstallationId を使用すると、特定のインストールからの測定値を照会できます。 |
|
緯度
|
location.latitude | float |
インストール座標 - 緯度。 地図上の正確なセンサー位置。 |
|
緯度
|
location.longitude | float |
インストール座標 - 経度。 地図上の正確なセンサー位置。 |
|
場所 ID
|
locationId | integer |
一意の場所識別子。 |
|
Country
|
address.country | string |
インストール国。 属性は省略可能で、空または null の場合があります。 |
|
市区町村
|
address.city | string |
インストール市区町村。 属性は省略可能で、空または null の場合があります。 |
|
Street
|
address.street | string |
インストールストリート。 属性は省略可能で、空または null の場合があります。 |
|
Number
|
address.number | string |
インストールの番地。 属性は省略可能で、空または null の場合があります。 |
|
表示アドレス 1
|
address.displayAddress1 | string |
学校名や番号など、住所を記述する追加のフィールド。 省略可能なフィールド。 |
|
表示アドレス 2
|
address.displayAddress2 | string |
学校名や番号など、住所を記述する追加のフィールド。 省略可能なフィールド。 |
|
Elevation
|
elevation | float |
デバイスがインストールされている高度。平均海面 (mamsl) の上のメートル。 |
|
Airly
|
airly | boolean |
このインストールが Airly デバイスかどうかを示すフラグ。たとえば、GIOŚ ステーションには false のフラグが設定されます。 |
|
ID (アイディー)
|
sponsor.id | integer |
スポンサー識別子。 |
|
名前
|
sponsor.name | string |
このインストールのスポンサーの名前。 |
|
Description
|
sponsor.description | string |
このインストールのスポンサーの追加の説明。 |
|
Logo
|
sponsor.logo | string |
スポンサーのロゴを指す URL (jpg 画像)。 |
|
Link
|
sponsor.link | string |
スポンサーの Web サイトを指す URL。 |
最も近い測定値を取得する
エンドポイントは、特定の場所に最も近いインストールの測定値を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | number |
10 進度の緯度 (例: 50.062006)。 |
|
緯度
|
lng | True | number |
10 進度の経度 (例: 19.940984)。 |
|
最大距離 (KM)
|
maxDistanceKM | float |
検索されたインストールは、指定されたポイント (km) からこの制限内に配置する必要があります。 負の値は制限がないことを意味します。 |
|
|
インデックスの種類
|
indexType | string |
計算して応答で返すインデックスの種類を選択します。 |
|
|
Language
|
Accept-Language | string |
テキストの説明を返す言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DateTime から - 現在
|
current.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - current
|
current.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
current.indexes | array of object |
インデックス - 現在。 |
|
インデックス名 - 現在
|
current.indexes.name | string |
インデックスの名前 (CAQI、PIJP など)。 |
|
インデックス値 - 現在
|
current.indexes.value | float |
計算されたインデックスの数値。 |
|
レベル - 現在
|
current.indexes.level | string |
インデックスの目立たないレベル (HIGH、LOW など)。 |
|
説明 - 現在
|
current.indexes.description | string |
インデックス レベルの説明。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
アドバイス - 現在
|
current.indexes.advice | string |
現在のインデックス レベルに関するアドバイスを含む追加のテキスト。 要求ヘッダーに従って翻訳され、言語で返 Accept-Language テキスト。 |
|
色 - 現在
|
current.indexes.color | string |
インデックス レベルを 16 進数の RGB トリプレット (例: #D1CF1E) で表す色。 |
|
standards
|
current.standards | array of object |
標準 - 最新。 |
|
標準名 - 現在
|
current.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 電流
|
current.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 現在
|
current.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 現在
|
current.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 現在
|
current.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
履歴
|
history | array of object |
履歴エントリ。 |
|
DateTime から - 履歴
|
history.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
Till DateTime - 履歴
|
history.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
history.indexes | array of object |
インデックス - 履歴。 |
|
標準名 - 履歴
|
history.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
history.standards | array of object |
標準 - 履歴。 |
|
標準名 - 履歴
|
history.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 歴史
|
history.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 履歴
|
history.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 履歴
|
history.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 履歴
|
history.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
予測
|
forecast | array of object |
予測エントリ。 |
|
DateTime から - 予測
|
forecast.fromDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された開始時刻を表します。 |
|
DateTime まで - 予測
|
forecast.tillDateTime | string |
タイムスタンプISO8601します。 UTC の日付と時刻。 このフィールドは、このペイロード内のデータが測定および平均された終了時刻を表します。 |
|
values
|
forecast.values | array of object |
値 - 予測。 |
|
測定名 - 予測
|
forecast.values.name | string |
指定された測定の名前 (型)。例: PM10。 |
|
測定値 - 予測
|
forecast.values.value | float |
所与の測定タイプの測定値、例えば濃度25μg/m3。 |
|
インデックス
|
forecast.indexes | array of object |
インデックス - 予測。 |
|
標準名 - 予測
|
forecast.indexes.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.indexes.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.indexes.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.indexes.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.indexes.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |
|
standards
|
forecast.standards | array of object |
標準 - 予測。 |
|
標準名 - 予測
|
forecast.standards.name | string |
この標準の名前。 現在、WHO 標準のみがサポートされています。 |
|
汚染物質 - 予測
|
forecast.standards.pollutant | string |
この規格が適用される汚染物質の名前。現在サポートされているのは PM10 と PM25 のみです。 |
|
制限 - 予測
|
forecast.standards.limit | float |
特定の期間にわたって超えてはならない汚染物質の一定の平均濃度レベル;つまり、これは汚染物質濃度が上限の100% に達する値です。 |
|
パーセント - 予測
|
forecast.standards.percent | float |
標準/限界におけるこの濃度のパーセンテージとして表される特定の汚染物質の濃度値は、例えばPM10の標準50μg/m3に対して25μg/m3の濃度は50%として表される。 |
|
平均化 - 予測
|
forecast.standards.averaging | string |
測定値は、近くのセンサー (指定されたポイントから最大 1,5km 離れた場所) からの平均測定によって補間されます。 |