Feature Representation

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Attributes), this format adds the format-specific attributes described in this section.

Each feature created in FME corresponds to one complete AIS message. Usually, one line in an AIS file corresponds to one AIS message, but in some cases, longer AIS messages are split over multiple messages. In this case, the multiple message pieces will be reconstructed into a single AIS message before feature construction.

There are numerous AIS messages types, each one with different data fields. Each message type corresponds to a feature type in FME. The corresponding feature type will store the data of the AIS message as attributes. In some cases, additional location-specific information will be stored as traits of the geometry for the feature type.

The table below lists the FME feature types and the AIS messages that they support.

To see the attributes of a certain FME feature type, generate a workspace with an AIS reader and view that feature type’s attributes. In many cases, the value of an attribute is a constant that corresponds to a certain string or value.

The table below lists sections of the specification. These sections provide tables that describe the values of these enumerations. These links are a good reference if the meaning or interpretation of the value of an attribute is desired.

Note: Not all of the type 6 and 8 subtypes are supported. Currently, the subtypes that are handled are subtypes specified by the International Maritime Organization (IMO). The format can be extended, however, to support additional subtypes upon request. If you would like added support for another binary subtype, please contact support@safe.com and provide a specification detailing the contents of the subtype.

Feature Type AIS Message Notes
ais_position_report

Type 1: Position Report Class A,

Type 2: Position Report Class A (Assigned Schedule),

Type 3: Position Report Class A (Response to interrogation)

AIS messages 1 – 3 all correspond to this type of position report. This is the most common type of AIS message seen and makes up the majority of what is found in typical datasets.

See Types 1, 2, and 3 Position Reports for information on how to interpret the attribute’s values.  

ais_base_station_report

Type 4: Base Station Report

Type 11: UTC/Date Response

Type 4 Base Station Report contains information on how to interpret the attribute’s values.

This message type is also relatively common.

ais_ship_static_and_voyage_related_data Type 5: Static and Voyage Related Data Type 5 Static and Voyage-Related Data contains information on how to interpret the attribute’s values.
ais_dangerous_cargo_indication

Type 6: Binary Addressed Message – Subtype: IMO236 Dangerous Cargo Indication

Type 6: Binary Addressed Message – Subtype: IMO289 Dangerous Cargo Indication

Type 6 Binary Addressed Messages contains information on how to interpret the attribute’s values.

See the section corresponding to the specific subtype(s).

ais_tidal_window

Type 6: Binary Addressed Message – Subtype: IMO236 Tidal Window

Type 6: Binary Addressed Message – Subtype: IMO289 Tidal Window

ais_number_persons_on_board

Type 6: Binary Addressed Message – Subtype: IMO236 Number of Persons on Board

Type 6: Binary Addressed Message – Subtype: IMO289 Number of Persons on Board

ais_text_description Type 6: Binary Addressed Message – Subtype: IMO289 Text Description (addressed)
ais_clearance_time_to_enter_port Type 6: Binary Addressed Message – Subtype: IMO289 Clearance Time to Enter Port
ais_route_information Type 6: Binary Addressed Message – Subtype: IMO289 Route Information (addressed)
ais_berthing_data Type 6: Binary Addressed Message – Subtype: IMO289 Berthing Data (addressed)
ais_area_notice

Type 6: Binary Addressed Message – Subtype: IMO289 Area Notice (addressed)

Type 8: Binary Broadcast message – Subtype: IMO289 Area Notice (broadcast)

Type 6 Binary Addressed Messages contains information on how to interpret the attribute’s values.

See the section corresponding to the specific subtype.

The type 8 version has the same structure and interpretation as the type 6, except for the fact the message is broadcast instead of addressed to a certain ship.

These messages contain an array of subareas over which the specific area notice applies. These areas are stored as an aggregate on the feature, and the aggregate can contain the following geometries: rectangles, sectors, polylines, and polygons, along with associated text.

ais_fairway_closed Type 8: Binary Broadcast message – Subtype: Fairway Closed

Type 8 Binary Broadcast Message contains information on how to interpret the attribute’s values.

See the section corresponding to this specific subtype.

ais_marine_traffic_signal Type 8: Binary Broadcast message – Subtype: IMO289 Marine Traffic Signal
ais_synthetic_target Type 8: Binary Broadcast message – Subtype: VTS-Generated/Synthetic Targets

Type 8 Binary Broadcast Message contains information on how to interpret the attribute’s values.

See the section corresponding to this specific subtype.

The last portion of this message contains an array of synthetic targets. The contents of which is stored as an aggregate on this feature type, with each geometry within that aggregate containing traits describing the target’s properties.

ais_weather_observation_from_ship_non_wmo Type 8: Binary Broadcast message – Subtype: IMO289 Weather Observation Report from Ship: Non-WMO Variant

Type 8 Binary Broadcast Message contains information on how to interpret the attribute’s values.

See the section corresponding to this specific subtype.

ais_weather_observation_from_ship_wmo Type 8: Binary Broadcast message – Subtype: IMO289 Weather Observation Report from Ship: Non-WMO Variant
ais_extended_ship_static_voyage_imo236 Type 8: Binary Broadcast message – Subtype: IMO236 Extended Ship Static and Voyage Related Data
ais_extended_ship_static_voyage_imo289 Type 8: Binary Broadcast message – Subtype: IMO289 Extended Ship Static and Voyage Related Data
ais_environmental_report Type 8: Binary Broadcast message – Subtype: IMO289 Environmental

Type 8 Binary Broadcast Message contains information on how to interpret the attribute’s values.

See the section corresponding to this specific subtype.

This feature type has an aggregate, which contains between 1 and 5 geometries. These geometries can either correspond to a location or be null. In either case, the traits of these geometries describe different types of environmental reports. The specifications for these reports can be found in the link above.

ais_meteorological_hydrological_data

Type 8: Binary Broadcast message – Subtype: IMO236 Meteorological and Hydrological Data

Type 8: Binary Broadcast message – Subtype: IMO289 Meteorological and Hydrological Data

Type 8 Binary Broadcast Message contains information on how to interpret the attribute’s values.

See the section corresponding to these specific subtypes.

ais_binary_message_unknown

Type 6: Binary Message With Unknown Subtype

Type 8: Binary Message With Unknown Subtype

Not all type 6 and 8 binary messages are currently supported in FME. In the case where the subtype is not supported, this feature type is created, which contains information on which subtype it is along with its raw binary payload.
ais_binary_acknowledge

Type 7: Binary Acknowledge

Type 13: Safety-Related Acknowledgement

Type 7 Binary Acknowledge contains information on how to interpret the attribute’s values.
ais_sar_aircraft_position_report Type 9: Standard SAR Aircraft Position Report Standard SAR Aircraft Position Report contains information on how to interpret the attribute’s values.
ais_utc_date_inquiry Type 10: UTC/Date Inquiry UTC/Date Inquiry contains information on how to interpret the attribute’s values.
ais_addressed_safety_related_message Type 12: Addressed Safety Related Message Addressed Safety Related Message contains information on how to interpret the attribute’s values.
ais_safety_related_broadcast_message Type 14: Safety-Related Broadcast Message Safety-Related Broadcast Message contains information on how to interpret the attribute’s values
ais_interrogation Type 15: Interrogation Interrogation contains information on how to interpret the attribute’s values.
ais_assignment_mode_command Type 16: Assignment Mode Command Assignment Mode Command contains information on how to interpret the attribute’s values
ais_dgnss_broadcast_binary_message Type 17: DGNSS Broadcast Binary Message DGNSS Broadcast Binary Message contains information on how to interpret the attribute’s values.
ais_standard_class_b_cs_position_report Type 18: Standard Class B CS Position Report Standard Class B CS Position Report contains information on how to interpret the attribute’s values.
ais_extended_class_b_cs_position_report Type 19: Extended Class B CS Position Report Extended Class B CS Position Report contains information on how to interpret the attribute’s values.
ais_data_link_management_message Type 20: Data Link Management Message Data Link Management Message contains information on how to interpret the attribute’s values.
ais_aid_to_navigation_report Type 21: Aid-to-Navigation Report Aid-to-Navigation Report contains information on how to interpret the attribute’s values.
ais_channel_management Type 22: Channel Management Channel Management contains information on how to interpret the attribute’s values.
ais_group_channel_command Type 23: Group Assignment Command Group Assignment Command contains information on how to interpret the attribute’s values.
ais_static_data_report Type 24: Static Data Report Static Data Report contains information on how to interpret the attribute’s values.
ais_single_slot_binary_message Type 25: Single Slot Binary Message Single Slot Binary Message contains information on how to interpret the attribute’s values. This message type is very rare and unlikely to be seen.
ais_multiple_slot_binary_message Type 26: Multiple Slot Binary Message Multiple Slot Binary Message contains information on how to interpret the attribute’s values. This message type is very rare and unlikely to be seen.
ais_long_range_Broadcast_message Type 27: Long Range AIS Broadcast message Long Range AIS Broadcast message contains information on how to interpret the attribute’s values. This message type is very rare and unlikely to be seen.

Attributes prefixed by ais_data_ correspond to information determined from the payload of the message, while attributes prefixed with ais_header correspond to information that was determined from the raw AIS message in the text file. For an example of ais_header, ais_header_prefix is any text found before the start of a raw AIS message. For an example of ais_data, ais_data_rate_of_turn is an attribute specific to the ais_position_report feature type and is found by decoding and interpreting the payload portion of the AIS message.

The table below lists the attributes prefixed with ais_header.

Attribute Name Contents
ais_header_prefix

Any text found before the start of a raw AIS message.

Range: Alphanumeric string

Default: No default

ais_header_message_type

The NMEA message type.

Range: “!AIVDM” or “!AIVDO”

Default: No default

ais_header_msg_id

Sequential message identifier for multi-sentence messages.

Range: Alphanumeric string

ais_header_comment

Free form text information.

Range: Alphanumeric string

Default: No default

ais_header_counter

Count for each occurrence of the parameter being attached to a line by a talker.

Range: Any positive integer

Default: No default

ais_header_destination_id

Identification of the intended destination device or process.

Range: Alphanumeric string

Default: No default

ais_header_group_code

String used to link sentences into groups.

Range: Alphanumeric string

Default: No default

ais_header_source_id

Identification of the source device or process.

Range: Alphanumeric string

Default: No default

ais_header_time_stamp

Time in seconds from midnight January 1, 1970.

Range: Any positive integer

Default: No default

ais_header_channel

AIS Channel.

Range: “A” or “B”

Default: No default