ArcGIS Velocity の FlightAware (サーフェス) フィード タイプは、FlightAware Firehose API に接続し、地表での移動位置に関するデータを受信します。
FlightAware (航空) および FlightAware (サーフェス) フィード タイプはどちらも同じ Firehose API に接続しますが、提供されるイベント タイプは異なります。
FlightAware (航空) フィードで提供されるイベント タイプの詳細
例
FlightAware (サーフェス) フィードの使用例を以下に示します。
- GIS アナリストは、FlightAware (サーフェス) フィード タイプを使用し、[車両位置] イベント タイプを使用して地上を走行する車両の地表での移動位置を GIS ワークフローに統合します。
- GIS アナリストは、リアルタイム解析で FlightAware (サーフェス) フィード タイプを使用し、[位置エントリーと位置イグジット] イベント タイプを使用して、航空機が事前定義されたポリゴンに進入または退出した際にアラートを送信します。
使用上の注意
フィードを操作する際には、以下の点に注意してください。
- [パスワード] パラメーターの値を、FlightAware で認証する際の認証情報に設定する必要があります。 ほとんどの場合、これはアカウント パスワードではなく、Firehose API キーに設定する必要があります。 既存のフィードを編集する場合は、[パスワード] パラメーターの値を再入力する必要があります。
- Velocity の [イベント タイプ] パラメーターには、[車両位置]、[地表位置と地表近傍位置]、[位置エントリーと位置イグジット] の 3 つのオプションが用意されています。 このパラメーターは、送信されるダウンリンク メッセージを識別します。 使用可能なイベント コードは、FlightAware で有効になっているサブスクリプション レイヤーによって異なります。
注意:
複数の値を含む [イベント タイプ] (例: [地表位置と地表近傍位置]) を選択した場合、フィードによって返されるデータには Ground_position および Near_surface_position タイプのイベントが含まれます。 一部のイベント タイプが不要な場合は、リアルタイム解析にフィードを追加した後、条件式によるフィルター処理ツールを使用し、type フィールドに基づいて目的のイベント タイプを返すことができます。
- Firehose API の [レート制限 (秒)] パラメーターでは、指定した間隔 (秒単位で指定) 内に同じ航空機からの最終位置が記録されている場合に、位置メッセージを破棄して接続を制限することができます。 データの可用性またはアカウントのサービス契約によって、設定できる最小間隔が制限される場合があります。 このパラメーターは、イベント タイプが [車両位置] および [地表位置と地表近傍位置] の場合のみ使用でき、デフォルト値は 60 秒です。
注意:
Velocity のこのフィード タイプは、常に利用可能な最新バージョンの FlightAware Firehose API に接続します。
イベント タイプ スキーマ
- イベント タイプ スキーマおよびフィールド定義は、FlightAware のドキュメントに記載されています。
- [イベント タイプ] パラメーターが複数のイベント タイプを含む値に設定されている場合 (例: [地表位置と地表近傍位置])、スキーマには Ground_position と Near_surface_position の両方に表示されたフィールドが含まれます。 以下を除き、表示されたすべてのフィールドが含まれます。
- [車両位置]: airport_locations
- [地表位置と地表近傍位置]: adsb_version、airport_locations、nac_p、nac_v、nic、nic_baro、pos_rc、sil、 sil_type
- [位置エントリーと位置イグジット]: airport_locations
- フィードの構成時に、不要なフィールドは [スキーマの確認] ページで選択解除できます。
パラメーター
以下は、このフィードのパラメーターです。
パラメーター | 説明 | データ タイプ |
---|---|---|
ホスト名 | FlightAware の接続に使用されるホスト名 - 例: firehose.flightaware.com。 | String |
ポート | FlightAware の接続に使用されるポート番号 - 例: 1501。 | Integer |
ユーザー名 | 認証に使用されるユーザー名。 ユーザー名は、アクセス権が付与されている FlightAware アカウントのユーザー名である必要があります。 | String |
パスワード | 認証に使用されるパスワード。 ほとんどの場合、これはアカウント パスワードではなく、Firehose API キーである必要があります。 | パスワード |
イベント タイプ | 送信されるダウンリンク メッセージのリスト。 指定できる値は、[車両位置]、[地表位置と地表近傍位置]、[位置エントリーと位置イグジット] です。 | String |
空港フィルター | 空港フィルターは、指定された glob パターンのスペース リストと一致する空港を出発地または目的地とする便のフライト情報のみを送信します (例: "CYUL"、“K??? P* TJSJ”)。 | String |
航空路線フィルター | 航空路線フィルターは、リストされた航空路線に関連するフライト情報のみを送信します。 このリストは、スペースで区切られた一連の ICAO 航空路線コードで構成されます (例: "FIN"、"FIN BAW AAL")。 | String |
空間範囲 | フィルター処理する空間範囲。 指定した四角形内の位置情報のみを送信します。フライトが他の条件に一致しない限り、他の位置情報は無視されます。 フライトが指定した地域に一致すると記憶され、そのフライト ID が着陸するまでの後続のすべてのメッセージは、フライトが指定した地域から外れても引き続き送信されます。 | 空間範囲 |
アイデント | リストされたアイデント (識別情報) または航空機登録番号または尾翼番号に関連するフライト情報のみを送信します。 このリストは、スペースで区切られた一連のアイデントまたは登録番号で構成されます (例: アイデント "N1234 N2345 N456 CXYZA"、“N1*UA N2*UA UAL?? UAL12 UAL34”)。 | String |
オペレーター タイプ | オペレーター タイプは、オペレーター タイプに基づいてフライト アイデントに関連するメッセージを送信します。 指定できる値は、[航空路線]、[一般的な航空]、[貨物] です。 | String |
レート制限 (秒) | レート制限では、指定した間隔 (秒単位) 内に同じ航空機からの最終位置が記録されている場合に、位置メッセージを破棄して接続を制限することができます。 データの可用性またはアカウントのサービス契約によって、設定できる最小間隔が制限される場合があります。 このパラメーターは、イベント タイプが [車両位置] および [地表位置と地表近傍位置] の場合のみ使用できます。 デフォルト値は 60 秒です。 | Integer |
検討事項と制限事項
このフィードを操作する場合、以下を考慮してください。
- Velocity は FlightAware Firehose API のライブ タイム レンジ機能を使用しており、現時点以降のリアルタイム データをリクエストすることができます。
- FlightAware Firehose API には、ユーザー アカウントごとに許容される最大接続数があります。 各 FlightAware (サーフェス) フィード タイプは、これらの接続のいずれかを使用します。 Velocity が接続を試みたものの、最大許容接続数に達している場合、Velocity はログ内で警告メッセージを表示します。
- Velocity が FlightAware から切断された場合、FlightAware によって返されたメッセージはフィードのログに記録され、再接続が試みられます。
- FlightAware では、古くなった接続や長時間実行されている接続を防ぐために、定期的に切断と再接続を行うことを推奨します。 このため、Velocity では、データが取り込まれない場合に定期的に切断と再接続が実行されます。 この動作により、フィードのログにログ メッセージが記録されます。