AISHub members are allowed to access AISHub webservice and retrieve AISHub data in XML or JSON format.
NOTE! Don’t access the webservice more frequently than once per minute! The web service will return nothing if executed more frequently!

Webservice URL

http://data.aishub.net/ws.php?username=A&format=B&output=C&compress=D&latmin=E&latmax=F&lonmin=G&lonmax=H&mmsi=I&imo=J
GLOBAL PARAMETERS
Ayour AISHub username. You will receive it after joining AISHub.
Bformat of data values (0 – AIS encoding , 1 – Human readable format)
Coutput format (xml, json, csv)
Dcompression (0 – no compression, 1 – ZIP, 2 – GZIP, 3 – BZIP2)

ADDITIONAL PARAMETERS
ESouth (minimum) latitude (default = -90)
FNorth (maximum) latitude (default = +90)
GWest (minimum) longitude (default = -180)
HEast (maximum) longitude (default = +180)
IMMSI number (webservice returns data for the requested vessel only)
JIMO number (webservice returns data for the requested vessel only)

Examples:

http://data.aishub.net/ws.php?username=USERNAME&format=1&output=xml&compress=1
                            

Returns all AISHub data as XML file (ZIP compression)

http://data.aishub.net/ws.php?username=USERNAME&format=1&output=json&compress=3&latmin=20.5&latmax=30.8&lonmin=-15&lonmax=18.6

Returns all vessels in an area with boundaries (South 20.5 / North 30.8 / West -15.0 / East 18.6) as JSON file (BZIP2 compression)

http://data.aishub.net/ws.php?username=USERNAME&format=1&output=json&compress=2&mmsi=123456789

Returns all data for vessel with MMSI 123456789

Output values

AIS format (B=0)

vessel MMSI="235085131"  TIME="1302264927"  LONGITUDE="-818067"  LATITUDE="30453520"  COG="2351"  SOG="59"  HEADING="511"  NAVSTAT="0"  PAC="0"  ROT="0"  IMO="0"  NAME="ZAC V"  CALLSIGN="ZIYX3"  TYPE="36"  DEVICE="0"  A="8"  B="4"  C="2"  D="2"  DRAUGHT="0"  DEST=""  ETA=""  AISVER="0"
                            

Human-readable format (B=1)

vessel MMSI="413811000"  TIME="2011-04-12 10:40:27 GMT"  LONGITUDE="118.44586666667"  LATITUDE="38.874833333333"  COG="356"  SOG="0.1"  HEADING="116"  NAVSTAT="1"  IMO="9118824"  NAME="JIN HAI XIANG"  CALLSIGN="BVKU"  TYPE="70"  A="197"  B="27"  C="20"  D="12"  DRAUGHT="7.5"  DEST="CAOFEIDIAN"  ETA="04-10 07:00"
                            

Explanation of data values:

MMSIMaritime Mobile Service Identity
TIMEdata timestamp AIS format – unix timestamp Human readable format – UTC
LONGITUDEgeographical longitude AIS format – in 1/10000 minute i.e. degrees multiplied by 600000 Human readable format – degrees
LATITUDEgeographical latitude AIS format – in 1/10000 minute i.e. degrees multiplied by 600000 Human readable format – degrees
COGCourse Over Ground AIS format – in 1/10 degrees i.e. degrees multiplied by 10. COG=3600 means “not available” Human readable format – degrees. COG=360.0 means “not available”
SOGSpeed Over Ground AIS format – in 1/10 knots i.e. knots multiplied by 10. SOG=1024 means “not available” Human readable format – knots. SOG=102.4 means “not available”
HEADINGcurrent heading of the AIS vessel at the time of the last message value in degrees, HEADING=511 means “not available”
PAC(AIS format only) – Position Accuracy 0 – low accuracy 1 – high accuracy
ROT(AIS format only) - Rate of Turn
NAVSTATNavigational Status
IMOIMO ship identification number
NAMEvessel’s name (max.20 chars)
CALLSIGNvessel’s callsign
TYPEvessel’s type (more details here)
DEVICEpositioning device type (more details here)
ADimension to Bow (meters)
BDimension to Stern (meters)
CDimension to Port (meters)
DDimension to Starboard (meters)
DRAUGHTAIS format – in 1/10 meters i.e. draught multiplied by 10. Human readable format – meters
DESTvessel’s destination
ETAEstimated Time of Arrival
AIS format (see here).
Human readable format – UTC date/time