nl.esi.metis.aisparser.AISMessage27 Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of EsiAisParser Show documentation

This package supports the parsing of AIS messages in Java. AIS, the Automatic Identification System, is a system aiming at improving maritime safety by exchanging messages between ships, other vehicles in particular aircraft involved in search-and-rescue (SAR), and (fixed) base stations. To be precise, this package support the ITU-R M.1371-4 AIS standard. See our extensive javadoc and in particular the class AISParser for more information on how to use this package. The parser was used in the Poseidon project, and is improved in the Metis project to better handle uncertain information. Both projects were led by the Embedded Systems Institute. In both projects Thales Nederlands was the carrying industrial partner, and multiple Dutch universities participated.

The newest version!

/* ESI AIS Parser
 * 
 * Copyright 2011/2012 by Pierre van de Laar & Pierre America (Embedded Systems Institute)
 * Copyright 2008 by Brian C. Lane 
 * All Rights Reserved
 * 
 */
package nl.esi.metis.aisparser;

/** This interface represents an AIS message of type 27: Long-range AIS broadcast message.
*
* @author Pierre van de Laar
* @author Pierre America
* @author Brian C. Lane
*/
public interface AISMessage27 extends AISMessage, PositionInfo {

	/** raimFlag
	 * @return boolean value of raimFlag (bit 40)
	 */
	public boolean getRaimFlag();

	/** Returns the navigational status.
	 * This can be further analyzed using utility class {@link UtilsNavStatus}.
	 * @return an integer in the range of 0 to 15: 

	 * 0 = under way using engine 

	 * 1 = at anchor 

	 * 2 = not under command 

	 * 3 = restricted maneuverability 

	 * 4 = constrained by her draught 

	 * 5 = moored 

	 * 6 = aground 

	 * 7 = engaged in fishing 

	 * 8 = under way sailing 

	 * 9 = reserved for future amendment of navigational status for ships carrying DG, HS, or MP, or IMO hazard or pollutant category C, high speed craft (HSC) 

	 * 10 = reserved for future amendment of navigational status for ships carrying dangerous goods (DG), harmful substances (HS) or marine pollutants (MP), 
	 *      or IMO hazard or pollutant category A, wing in grand (WIG) 

	 * 11-13 = reserved for future use 

	 * 14 = AIS-SART (active) 

	 * 15 = not defined = default (also used by AIS-SART under test)
	 */
	public int getNavigationalStatus();

	/** speedOverGround (6 bits)
	 * @return int value of speedOverGround (6 bits [80,85])
	 */
	public int getSpeedOverGround();

	/** courseOverGround (9 bits)
	 * This value can be analyzed further with utility class {@link UtilsAngle9}.
	 * @return int value of courseOverGround (9 bits [86,94])
	 */
	public int getCourseOverGround();

	/** statusOfCurrentGNSSPosition
	 * @return boolean value of statusOfCurrentGNSSPosition (bit 95)
	 */
	public boolean getStatusOfCurrentGNSSPosition();

	/** spare
	 * @return int value of spare (1 bits [96,96])
	 */
	public int getSpare();

}