ArcGIS Velocity 中的 FlightAware（表面）源类型可建立与 FlightAware Firehose API 的连接，以接收与表面运动位置相关的数据。
了解有关 FlightAware Firehose API 的详细信息
FlightAware（机载）和 FlightAware（表面）源类型都连接到相同的 Firehose API，但提供的事件类型不同。
了解有关 FlightAware（机载）源提供的事件类型的详细信息
示例
以下是 FlightAware（表面）源的使用示例：
- GIS 分析师使用FlightAware（表面）源类型将地面车辆地面移动位置整合到使用车辆位置事件类型的 GIS 工作流中。
- GIS 分析师在实时分析中通过 FlightAware（表面）源类型使用位置进入和退出事件类型在飞机进入或离开预定义面时发送警告。
用法说明
使用源时，请谨记以下内容：
- 密码参数的值应设置为用于 FlightAware 身份验证的凭据。 在大多数情况下，应将其设置为 Firehose API 密钥，而不是账户密码。 如果现有源已被编辑，则需要重新输入密码参数的值。
- Velocity 为事件类型参数提供三种选项：车辆位置、地面位置和近表面位置，以及位置进入和退出。 此参数可确定将发送哪些下行消息。 可用的事件代码取决于在 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。 | 字符串 |
端口 | 用于连接到 FlightAware 的端口号，例如 1501。 | 整型 |
用户名 | 用于身份验证的用户名。 用户名应为已授予访问权限的 FlightAware 账户用户名。 | 字符串 |
密码 | 用于身份验证的密码。 在大多数情况下，它应该是 Firehose API 密钥，而不是账户密码。 | 密码 |
| 事件类型 | 要发送的下行消息的列表。 允许的值包含车辆位置、地面位置和近表面位置，以及位置进入和退出。 | 字符串 |
机场过滤器 | 机场过滤器仅为飞行发送飞行信息，这些信息来自或发送至与指定的 glob 模式空间列表匹配的机场，例如“CYUL”或“K??? P* TJSJ”。 | 字符串 |
航空公司过滤器 | 航空公司过滤器仅发送与列出的航空公司相关的飞行信息。 该列表由一系列以空格分隔的 ICAO 航空公司代码组成，例如“FIN”或“FIN BAW AAL”。 | 字符串 |
空间范围 | 要作为筛选依据的空间范围。 仅发送指定矩形范围内的位置；除非飞行与其他条件匹配，否则将会忽略其他位置。 如果飞行与所提供的区域匹配，则该飞行会被记住，即使飞行不再位于指定区域，也会继续发送该飞行 ID 对应的所有后续消息，直到着陆。 | 空间范围 |
标识符 | 仅发送与所列标识符（标识）或飞机注册号/尾号相关的航班信息。 该列表由一系列以空格分隔的标识符或注册号组成，例如，标识符“N1234 N2345 N456 CXYZA”或“N1*UA N2*UA UAL?? UAL12 UAL34”。 | 字符串 |
运营类型 | 运营类型可根据运营类型发送与飞行标识符相关的消息。 允许的值包括航空公司、通用航空和货运。 | 字符串 |
速率限制（秒） | 如果来自同一飞机的最后一个位置是在指定间隔（以整秒为单位）内记录的，则速率限制可通过放弃位置消息来限制连接。 数据可用性和/或您账户的服务合同可能会限制您可以设置的最小间隔。 此参数仅适用于车辆位置和地面位置和近表面位置事件类型。 默认值为 60 秒。 | 整型 |
注意事项和限制
使用此源时，请考虑以下内容：
- Velocity 使用 FlightAware Firehose API 的实时时间范围功能，允许其请求从当前时间开始的实时数据。
- FlightAware Firehose API 的每个用户账户存在允许的最大连接数。 每种 FlightAware（表面）源类型使用其中的一种连接。 如果 Velocity 尝试连接，但达到允许的最大连接数，则 Velocity 会在日志中显示警告消息。
- 如果 Velocity 从 FlightAware 断开连接，则会在源日志中记录 FlightAware 返回的消息，并且尝试重新连接。
- FlightAware 建议定期断开连接并重新连接，以防止连接失效或长时间运行。 因此，如果未提取到任何数据，则请定期断开 Velocity 连接并重新连接。 此行为会导致源日志中出现日志消息。