Тип канала FlightAware (Surface) в ArcGIS Velocity подключается к FlightAware Firehose API для получения данных, связанных с поверхностью позиций движения.
Более подробно о FlightAware Firehose API
Оба типа каналов - FlightAware (воздушный) и FlightAware (наземный) - подключаются к одному и тому же Firehose API, но различаются предлагаемыми типами событий.
Подробнее о типах событий в канале FlightAware (Airborne).
Примеры
Ниже приведены примеры использования канала FlightAware (Surface):
- ГИС-Аналитик использует канал FlightAware (Surface) для интеграции положений перемещения транспорта по поверхности с рабочими процессами ГИС с помощью типа событий Положение транспорта.
- ГИС-Аналитик использует канал FlightAware (Surface) в аналитике в реальном времени для отправки уведомлений, когда воздушное судно входит или выходит из предопределенного полигона с помощью типа событий Вход в местоположение и выход из него.
Примечания по использованию
При работе с этим каналом учитывайте следующее:
- Значение параметра Пароль должно быть установлено в соответствии с учетными данными для аутентификации в FlightAware. В большинстве случаев вместо пароля учетной записи следует указать ключ API Firehose. При редактировании существующего канала значение параметра Пароль необходимо будет ввести повторно.
- Velocity предлагает три опции для параметра Тип событий: Положение транспорта, Положение на земле и положение у поверхности и Вход в местоположение и выход из него. Этот параметр определяет, какие сообщения с воздушного судна будут отправляться. Доступные коды событий зависят от слоев подписки, включенных в FlightAware.
Примечание:
Если вы выберете Тип событий с несколькими значениями, такой как Положение на земле и положение у поверхности, возвращенные каналом данные будут включать события и типа Ground_position, и типа Near_surface_position. Если вам не нужны все типы событий, вы можете использовать инструмент Фильтр по выражению после добавления канала в аналитику в реальном времени, чтобы вернуть требуемые типы событий на основе поля type.
- Параметр Ограничение частоты (секунды) для API Firehose позволяет вам ограничивать подключение, отбрасывая сообщения о положении, если последнее положение того же самолета уже передавалось в течение указанного интервала (в целых секундах). Доступность данных и/или договор на обслуживание вашей учетной записи могут ограничивать минимальный интервал, который вы можете задать. Этот параметр доступен только для типов событий Положение транспорта и Положение на земле и положение у поверхности со значением по умолчанию - 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. | Integer |
Имя пользователя | Имя пользователя, используемое для аутентификации. Имя пользователя должно быть именем пользователя учетной записи FlightAware, которой предоставлен доступ. | Строка |
Пароль | Пароль, используемый для аутентификации. В большинстве случаев следует указать ключ API Firehose, а не пароль учетной записи. | Пароль |
| Тип события | Список сообщений о воздушных судах, которые должны отправляться. Допустимы следующие значения: Положение транспорта, Положение на земле и положение у поверхности и Вход в местоположение и выход из него. | Строка |
Фильтр аэропортов | Фильтр аэропортов передает информацию о рейсах только для рейсов, отправляющихся из аэропортов или направляющихся в аэропорты в соответствии с разделенным пробелами списком глобальных шаблонов, например, "CYUL" или “K???. P* TJSJ”. | Строка |
Фильтр авиакомпаний | Фильтр авиакомпаний используется для передачи информации о рейсах только перечисленных авиакомпаний. Список представляет собой набор разделенных пробелами кодов авиакомпаний ИКАО, например, "FIN" или "FIN BAW AAL". | Строка |
Пространственный экстент | Пространственный экстент, по которому вы хотите выполнить фильтрацию. Отправляет только местоположения внутри заданного прямоугольника. Остальные местоположения будут игнорироваться, если только рейс не соответствует другим критериям. Если рейс соответствует заданной области, он запоминается, и все последующие сообщения для этого идентификатора рейса продолжают отправляться до посадки, даже если рейс перестает больше не в этой области. | Пространственный экстент |
Идентификаторы | Используется для передачи информации о полетах, относящейся только к указанным идентификаторам (идентификации) или регистрационным данным самолетов. Список состоит из ряда разделенных пробелами идентификаторов или регистраций, например, идентификаторов "N1234 N2345 N456 CXYZA" или “N1*UA N2*UA UAL?? UAL12 UAL34” . | Строка |
Тип оператора | Тип оператора отправляет сообщения, относящиеся к идентификаторам рейсов, в зависимости от типа оператора. Допустимые значения - Авиакомпания, Авиация общего назначения и Грузовые. | Строка |
Ограничение частоты (в секундах) | Ограничение частоты позволяет вам ограничивать подключение, отбрасывая сообщения о положении, если последнее положение того же самолета уже передавалось в течение указанного интервала (в целых секундах). Доступность данных и/или договор на обслуживание вашей учетной записи могут ограничивать минимальный интервал, который вы можете задать. Этот параметр доступен только для типов событий Положение транспорта и Положение на земле и положение у поверхности. Значение по умолчанию – 60 секунд. | Integer |
Рассмотрение и ограничения
При работе с этим каналом учитывайте следующее.
- Velocity использует функцию FlightAware Firehose API-интерфейса с временным диапазоном в реальном времени, что позволяет запрашивать данные в режиме реального времени, начиная с текущего момента.
- У API FlightAware Firehose есть максимально возможное количество подключений на каждую учетную запись пользователя. Каждый канал FlightAware (Surface) использует одно из этих подключения. Если Velocity попытается подключиться, но достигнет максимального числа подключений, Velocity покажет предупреждающее сообщение в журнале.
- Если Velocity отключается от FlightAware, сообщение, возвращаемое FlightAware, регистрируется в журналах канала, и предпринимается попытка повторного подключения.
- FlightAware рекомендует периодически отключаться и подключаться снова, чтобы предотвратить появление устаревших или длительно работающих соединений. Поэтому при отсутствии данных происходит регулярное отключение и повторное подключение Velocity. Такое поведение приводит к появлению сообщения в журнале канала.