Airly (Independent Publisher)
Airly は、コミュニティの大気汚染に関する正確なハイパー ローカル データを提供します。 これは、健康上のリスクを理解し、改善するための最初のステップです。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | トーマス・ポズィテク |
| [URL] | https://aka.ms/poszytek |
| メール | tomasz@poszytek.eu |
| Connector Metadata | |
|---|---|
| 発行者 | トーマス・ポズィテク |
| Web サイト | https://airly.org/ |
| プライバシー ポリシー | https://airly.org/en/terms-conditions/ |
| カテゴリ | モノのインターネット; ライフスタイルとエンターテインメント |
接続の作成
コネクタは、次の認証タイプをサポートしています。
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | この API の API キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ID で装置を取得 |
操作は、InstallationId で指定された単一の装置メタデータを返します。 |
| ポイントの測定値を取得する |
エンドポイントは、地理的な場所の測定値を返します。 測定値は、近くのセンサー (指定されたポイントから最大 1.5 km離れた場所) からの測定値を平均することによって補間されます。 戻り値は加重平均であり、重みはセンサーから指定されたポイントまでの距離に反比例します。 |
| 使用可能なインデックスを取得 |
エンドポイントは、API でサポートされているすべてのインデックス タイプのリストと、インデックス タイプごとに定義されたレベルのリストを返します。 |
| 使用可能な測定を取得 |
エンドポイントは、API でサポートされているすべての測定タイプのリストとその名前および単位を返します。 |
| 最寄りの測定の取得 |
エンドポイントは、指定された場所に最も近い装置の測定値を返します。 |
| 最寄りの装置を取得する |
エンドポイントは、指定されたポイントに最も近い装置のリストを、そのポイントまでの距離でソートして返します。 |
| 装置の測定値を取得する |
エンドポイントは、InstallationId で指定された固定装置の測定値を返します。 |
ID で装置を取得
操作は、InstallationId で指定された単一の装置メタデータを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
装置 ID
|
InstallationID | True | integer |
メタデータを取得するための単一装置の ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | integer |
一意の装置識別子。 InstallationId を使用すると、特定の装置からの測定値をクエリできます。 |
|
緯度
|
location.latitude | float |
装置の座標 (緯度)。 地図上のセンサーの正確な位置。 |
|
経度
|
location.longitude | float |
装置の座標 (経度)。 地図上のセンサーの正確な位置。 |
|
場所 ID
|
locationId | integer |
一意の場所識別子。 |
|
国
|
address.country | string |
装置の国。 属性 はオプションです。空または null にできます。 |
|
都市
|
address.city | string |
装置の都市。 属性 はオプションです。空または null にできます。 |
|
番地
|
address.street | string |
装置の番地。 属性 はオプションです。空または null にできます。 |
|
番地
|
address.number | string |
装置の番地。 属性 はオプションです。空または null にできます。 |
|
表示住所 1
|
address.displayAddress1 | string |
住所を説明する追加のフィールド (学校名や番号など)。 オプション フィールド。 |
|
表示住所 2
|
address.displayAddress2 | string |
住所を説明する追加のフィールド (学校名や番号など)。 オプション フィールド。 |
|
標高
|
elevation | float |
デバイスが設置されている高度。平均海抜メートル (mamsl)。 |
|
Airly
|
airly | boolean |
この装置が Airly デバイスであるかどうかを示すフラグ。たとえば、GIOŚ ステーションには false のフラグが付けられます。 |
|
Id
|
sponsor.id | integer |
スポンサー識別子。 |
|
名前
|
sponsor.name | string |
この装置のスポンサーの名前。 |
|
説明
|
sponsor.description | string |
この装置のスポンサーの追加説明。 |
|
ロゴ
|
sponsor.logo | string |
スポンサーのロゴを指す URL (jpg 画像)。 |
|
リンク
|
sponsor.link | string |
スポンサーの Web サイトを指す URL。 |
ポイントの測定値を取得する
エンドポイントは、地理的な場所の測定値を返します。 測定値は、近くのセンサー (指定されたポイントから最大 1.5 km離れた場所) からの測定値を平均することによって補間されます。 戻り値は加重平均であり、重みはセンサーから指定されたポイントまでの距離に反比例します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | number |
小数点以下の緯度 (例: 50.062006)。 |
|
経度
|
lng | True | number |
小数点以下の経度 (例: 19.940984)。 |
|
インデックスの種類
|
indexType | string |
計算して応答として返すインデックスの種類を選択します。 |
|
|
言語
|
Accept-Language | string |
テキストの説明を返す必要がある言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
開始 DateTime - 現在
|
current.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 現在
|
current.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
history
|
history | array of object |
履歴エントリ。 |
|
開始 DateTime - 履歴
|
history.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 履歴
|
history.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
forecast
|
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。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
使用可能なインデックスを取得
エンドポイントは、API でサポートされているすべてのインデックス タイプのリストと、インデックス タイプごとに定義されたレベルのリストを返します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
インデックス名
|
name | string |
インデックスの名前。 |
|
levels
|
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 でサポートされているすべての測定タイプのリストとその名前および単位を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
言語
|
Accept-Language | string |
テキストの説明を返す必要がある言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
名前
|
name | string |
この測定値タイプの名前。例: PM10。 |
|
ラベル
|
label | string |
この測定タイプの説明的な名前 (フィールドは翻訳される)。 |
|
単位
|
unit | string |
この測定値タイプの単位。例: µg/m3。 |
最寄りの測定の取得
エンドポイントは、指定された場所に最も近い装置の測定値を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | number |
小数点以下の緯度 (例: 50.062006)。 |
|
経度
|
lng | True | number |
小数点以下の経度 (例: 19.940984)。 |
|
最大距離 (KM)
|
maxDistanceKM | float |
検索される装置は、指定されたポイント (km 単位) からこの制限内に配置されている必要があります。 負の値は制限がないことを意味します。 |
|
|
インデックスの種類
|
indexType | string |
計算して応答として返すインデックスの種類を選択します。 |
|
|
言語
|
Accept-Language | string |
テキストの説明を返す必要がある言語。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
開始 DateTime - 現在
|
current.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 現在
|
current.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
history
|
history | array of object |
履歴エントリ。 |
|
開始 DateTime - 履歴
|
history.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 履歴
|
history.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
forecast
|
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。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
最寄りの装置を取得する
エンドポイントは、指定されたポイントに最も近い装置のリストを、そのポイントまでの距離でソートして返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
緯度
|
lat | True | float |
小数点以下の緯度 (例: 50.062006)。 |
|
経度
|
lng | True | float |
小数点以下の経度 (例: 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 |
一意の場所識別子。 |
|
国
|
address.country | string |
装置の国。 属性 はオプションです。空または null にできます。 |
|
都市
|
address.city | string |
装置の都市。 属性 はオプションです。空または null にできます。 |
|
番地
|
address.street | string |
装置の番地。 属性 はオプションです。空または null にできます。 |
|
番地
|
address.number | string |
装置の番地。 属性 はオプションです。空または null にできます。 |
|
表示住所 1
|
address.displayAddress1 | string |
住所を説明する追加のフィールド (学校名や番号など)。 オプション フィールド。 |
|
表示住所 2
|
address.displayAddress2 | string |
住所を説明する追加のフィールド (学校名や番号など)。 オプション フィールド。 |
|
標高
|
elevation | float |
デバイスが設置されている高度。平均海抜メートル (mamsl)。 |
|
Airly
|
airly | boolean |
この装置が Airly デバイスであるかどうかを示すフラグ。たとえば、GIOŚ ステーションには false のフラグが付けられます。 |
|
Id
|
sponsor.id | integer |
スポンサー識別子。 |
|
名前
|
sponsor.name | string |
この装置のスポンサーの名前。 |
|
説明
|
sponsor.description | string |
この装置のスポンサーの追加説明。 |
|
ロゴ
|
sponsor.logo | string |
スポンサーのロゴを指す URL (jpg 画像)。 |
|
リンク
|
sponsor.link | string |
スポンサーの Web サイトを指す URL。 |
装置の測定値を取得する
エンドポイントは、InstallationId で指定された固定装置の測定値を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
装置 ID
|
installationId | True | integer |
測定値が返される装置 ID。 |
|
言語
|
Accept-Language | string |
テキストの説明を返す必要がある言語。 |
|
|
インデックスの種類
|
indexType | string |
計算して応答として返すインデックスの種類を選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
開始 DateTime - 現在
|
current.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 現在
|
current.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
current.values | array of object |
値 - 現在。 |
|
測定名 - 現在
|
current.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 現在
|
current.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
history
|
history | array of object |
履歴エントリ。 |
|
開始 DateTime - 履歴
|
history.fromDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された開始時刻を表します。 |
|
終了 DateTime - 履歴
|
history.tillDateTime | string |
ISO8601 タイムスタンプ。 日付と時刻 (UTC)。 このフィールドは、このペイロードのデータが測定および平均化された終了時刻を表します。 |
|
values
|
history.values | array of object |
値 - 履歴。 |
|
測定名 - 履歴
|
history.values.name | string |
指定された測定値の名前 (タイプ)。例: PM10。 |
|
測定値 - 履歴
|
history.values.value | float |
所定の測定タイプの測定値。たとえば濃度 25µg/m3。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
forecast
|
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。 |
|
indexes
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |
|
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.5 km離れた場所) からの測定値を平均することによって補間されます。 |