Service Info
Description
Get the latest available position or voyage information for vessels operating in the area you define with each call
Endpoint URL
https://api.myshiptracking.com/vesselsinarea/v:1
Parameters
| Parameter | Required | Type | Default value | Description |
|---|---|---|---|---|
| apikey | yes | text | Your 42-character personal API key | |
| resp | no | text | simple | simple: Response includes Basic information. extended: Response includes extra fields as discribe in the next section. |
| src | no | text | ter | ter: Response is the latest available received by terrestrial ais. sat: Response is the latest available received in combination of terrestrial-ais and satellite-ais. (If the latest position was received by terrestrial receivers you will be charged as Terrestrial-AIS) |
| timespan | no | int | 60 | The maximum age in minutes of the returned position. Min Value: 1 Max Value: 1440 |
| format | no | text | xml | Response type. Use one of the following: xml, json |
| minlat | yes (use all the options) | float | Min Latitude | |
| maxlat | float | Max Latitude | ||
| minlon | float | Min Longitude | ||
| maxlon | float | Max Longitude |
Response Fields - simple
| Field | Type | Description |
|---|---|---|
| MMSI | int | Maritime Mobile Service Identity |
| IMO | int | International Maritime Organisation number |
| LAT | real | Latitude |
| LNG | real | Longitude |
| HEADING | real | The heading (in degrees) |
| COURSE | real | The course (in degrees) |
| SPEED | real | The speed (in knots) |
| ROT | int | Rate of Turn |
| TIMESTAMP | datetime | The date and time (in UTC) that the data was received |
| SRC | text | Source of AIS data - TER: Terrestrial-AIS or SAT: Satellite-AIS |
Response Fields - extended
Including all simple response fields +
| Field | Type | Description |
|---|---|---|
| NAME | text | Name of the vessel |
| CALLSIGN | text | Callsign of the vessel |
| VTYPE | int | Type of the vessel according to AIS |
| VTYPE_TEXT | text | Type of the vessel in readable format |
| SIZE_A | int | Length (meters) from GPS antenna to the Bow of the vessel |
| SIZE_B | int | Length (meters) from GPS antenna to the Stern of the vessel (SIZE_A + SIZE_B = Vessel Total Length) |
| SIZE_C | int | Length (meters) from GPS antenna to the Port of the vessel |
| SIZE_D | int | Length (meters) from GPS antenna to the Starboard of the vessel (SIZE_C + SIZE_D = Vessel Total Width) |
| DRAUGHT | real | Current draught (meters) of the vessel |
| FLAG | text | Two digit Country Code |
| FLAG_MID | int | Maritime Identification Digit |
| GRT | int | Gross Tonnage - If available |
| DWT | int | Deadweight - If available |
| YEAR_BUILT | int | The year that the vessel was built - If available |
| DESTINATION | text | The reported destination according to AIS |
| ETA | datetime | The reported estimated time of arrival according to AIS (in UTC) |
| CURRENT_PORT | text | The name of the port the vessel is currently in (If detected by MyShipTracking) |
| CURRENT_PORT_ID | int | The assigned ID by MyShipTracking for the Current Port |
| CURRENT_PORT_UNLOCO | text | The UNLOCO for the Current Port |
| CURRENT_PORT_COUNTRY | text | The Country name of the Current Port |
| CURRENT_PORT_ARR | datetime | The Date and Time (in UTC) that the vessel arrived at the Current Port |
| CURRENT_PORT_ARR_LT | datetime | The Date and Time (in Local Time) that the vessel arrived at the Current Port |
| LAST_PORT | text | The name of the last detected port the vessel has visited |
| LAST_PORT_ID | int | The assigned ID by MyShipTracking of the last detected port the vessel has visited |
| LAST_PORT_UNLOCO | text | The UNLOCO of the Last Port |
| LAST_PORT_COUNTRY | text | The Country name of the Last Port |
| LAST_PORT_DEP | datetime | The Date and Time (in UTC) that the vessel departed from the Last Port (if it was in coverage that time) |
| LAST_PORT_DEP_LT | datetime | The Date and Time (in Local Time) that the vessel departed from the Last Port (if it was in coverage that time) |
| NEXT_PORT | text | The name of the Next Port as detected by MyShipTracking based on the vessel's reported Destination |
| NEXT_PORT_ID | id | The assigned ID by MyShipTracking of the Next Port |
| NEXT_PORT_UNLOCO | text | The UNLOCO of the Next Port |
| NEXT_PORT_COUNTRY | text | The Country name of the Next Port |
| NEXT_PORT_ETA | datetime | The Estimated Time of Arrival (in UTC) to Next Port according to MyShipTracking calculations - If available |
| NEXT_PORT_ETA_LT | datetime | The Estimated Time of Arrival (in Local Time) to Next Port according to MyShipTracking calculations - If available |
| AVG_SOG | real | Average speed in knots for the current trip |
| MAX_SOG | real | Maximum recorded speed in knots for the current trip |
| DISTANCE_COVERED | real | Distance covered (in Nautical Miles) from the last port till now |
| WIND_KNOTS | real | Wind speed in knots |
| WIND_DIRECTION | text | Wind direction |
| HUMIDITY | real | Humidity (%) |
| PRESSURE | real | Atmospheric pressure (kPa) |
| TEMPERATURE | real | Temperature in Celsius |
| CLOUD_COVERAGE | real | Cloud coverage (%) |
| PRECIPITATION | real | Precipitation (mm) |
| VISIBILITY | int | Visibility in meters |
Usage Example
https://api.myshiptracking.com/vesselsinarea/v:1/apikey:YOUR-API-KEY/src:sat/minlat:35.2276723/maxlat:36.20184/minlon:20.747680/maxlon:24.34570/timespan:10
<VESSEL>
<POS MMSI="352914000" IMO="9302748" LAT="36.06299" LNG="24.21744" HEADING="105" COURSE="107.6" SPEED="11.7" ROT="0" TIMESTAMP="2019-02-17T08:56:35" SRC="TER" />
<POS MMSI="667001713" IMO="8917742" LAT="35.27814" LNG="22.22928" HEADING="242" COURSE="242.2" SPEED="11.4" ROT="0" TIMESTAMP="2019-02-17T08:52:31" SRC="SAT" />
<POS MMSI="636018296" IMO="9222986" LAT="36.00333" LNG="22.55667" HEADING="273" COURSE="273" SPEED="20" ROT="0" TIMESTAMP="2019-02-17T08:48:52" SRC="SAT" />
<POS MMSI="304138000" IMO="9006382" LAT="36.07003" LNG="23.20135" HEADING="237" COURSE="232.9" SPEED="8.2" ROT="0" TIMESTAMP="2019-02-17T08:48:28" SRC="SAT" />
</VESSEL>
https://api.myshiptracking.com/vesselsinarea/v:1/apikey:YOUR-API-KEY/src:sat/resp:extended/minlat:35.2276723/maxlat:36.20184/minlon:20.747680/maxlon:24.34570/timespan:10
<VESSEL>
<POS MMSI="352914000" IMO="9302748" LAT="36.05753" LNG="24.23967" HEADING="102" COURSE="104" SPEED="11.7" ROT="0" TIMESTAMP="2019-02-17T09:02:24" SRC="TER" NAME="ORION III" CALLSIGN="H3YY" VTYPE="70" VTYPE_TEXT="Bulk Carrier" SIZE_A="194" SIZE_B="31" SIZE_C="22" SIZE_D="10" DRAUGHT="13.8" FLAG="PA" FLAG_MID="352" GRT="39727" DWT="76602" YEAR_BUILT="2005" DESTINATION="SA JED" ETA="2019-02-22T09:00:00" CURRENT_PORT="" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCO="" CURRENT_PORT_COUNTRY="" CURRENT_PORT_ARR="" CURRENT_PORT_ARR_LT="" LAST_PORT="LIVERPOOL" LAST_PORT_ID="274" LAST_PORT_UNLOCO="GBLIV" LAST_PORT_COUNTRY="United Kingdom" LAST_PORT_DEP="2019-01-03T07:01:01" LAST_PORT_DEP_LT="2019-01-03T07:01:01" NEXT_PORT="JEDDAH" NEXT_PORT_ID="3441" NEXT_PORT_UNLOCO="SAJED" NEXT_PORT_COUNTRY="Saudi Arabia" NEXT_PORT_ETA="" NEXT_PORT_ETA_LT="" AVG_SOG="12.2" MAX_SOG="19.5" DISTANCE_COVERED="5012.11" WIND_KNOTS="22" WIND_DIRECTION="NNE" HUMIDITY="73.5" PRESSURE="1023.9" TEMPERATURE="12.7" CLOUD_COVERAGE="47" PRECIPITATION="0" VISIBILITY="19800" />
<POS MMSI="667001713" IMO="8917742" LAT="35.27814" LNG="22.22928" HEADING="242" COURSE="242.2" SPEED="11.4" ROT="0" TIMESTAMP="2019-02-17T08:52:31" SRC="SAT" NAME="OMEGA STAR" CALLSIGN="9LU2516" VTYPE="79" VTYPE_TEXT="General Cargo" SIZE_A="84" SIZE_B="20" SIZE_C="6" SIZE_D="10" DRAUGHT="6" FLAG="SL" FLAG_MID="667" GRT="3828" DWT="4454" YEAR_BUILT="1991" DESTINATION="LY MRA" ETA="2019-02-19T12:00:00" CURRENT_PORT="" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCO="" CURRENT_PORT_COUNTRY="" CURRENT_PORT_ARR="" CURRENT_PORT_ARR_LT="" LAST_PORT="MIDIA" LAST_PORT_ID="297" LAST_PORT_UNLOCO="ROMID" LAST_PORT_COUNTRY="Romania" LAST_PORT_DEP="2019-02-14T15:48:44" LAST_PORT_DEP_LT="2019-02-14T17:48:44" NEXT_PORT="MISURATA" NEXT_PORT_ID="3197" NEXT_PORT_UNLOCO="LYMRA" NEXT_PORT_COUNTRY="Libya" NEXT_PORT_ETA="" NEXT_PORT_ETA_LT="" AVG_SOG="11.4" MAX_SOG="13.3" DISTANCE_COVERED="693.85" WIND_KNOTS="22" WIND_DIRECTION="NE" HUMIDITY="67.9" PRESSURE="1024.7" TEMPERATURE="12.7" CLOUD_COVERAGE="0" PRECIPITATION="0" VISIBILITY="24100" />
<POS MMSI="636018296" IMO="9222986" LAT="36.00333" LNG="22.55667" HEADING="273" COURSE="273" SPEED="20" ROT="0" TIMESTAMP="2019-02-17T08:48:52" SRC="SAT" NAME="E.R. LOS ANGELES" CALLSIGN="A8AX8" VTYPE="70" VTYPE_TEXT="Container Ship" SIZE_A="186" SIZE_B="91" SIZE_C="20" SIZE_D="20" DRAUGHT="12.9" FLAG="LR" FLAG_MID="636" GRT="66058" DWT="68131" YEAR_BUILT="2001" DESTINATION="TRALI-PTSIE" ETA="2019-02-20T23:00:00" CURRENT_PORT="" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCO="" CURRENT_PORT_COUNTRY="" CURRENT_PORT_ARR="" CURRENT_PORT_ARR_LT="" LAST_PORT="NEMRUT" LAST_PORT_ID="57" LAST_PORT_UNLOCO="TRNEM" LAST_PORT_COUNTRY="Turkey" LAST_PORT_DEP="2019-02-16T18:28:10" LAST_PORT_DEP_LT="2019-02-16T21:28:10" NEXT_PORT="SINES" NEXT_PORT_ID="2731" NEXT_PORT_UNLOCO="PTSIE" NEXT_PORT_COUNTRY="Portugal" NEXT_PORT_ETA="2019-02-20T17:33:30" NEXT_PORT_ETA_LT="2019-02-20T17:33:30" AVG_SOG="20.8" MAX_SOG="21.7" DISTANCE_COVERED="291.43" WIND_KNOTS="18" WIND_DIRECTION="NNE" HUMIDITY="61.9" PRESSURE="1025.1" TEMPERATURE="12" CLOUD_COVERAGE="2" PRECIPITATION="0" VISIBILITY="24100" />
<POS MMSI="304138000" IMO="9006382" LAT="36.07003" LNG="23.20135" HEADING="237" COURSE="232.9" SPEED="8.2" ROT="0" TIMESTAMP="2019-02-17T08:48:28" SRC="SAT" NAME="MY MELODY" CALLSIGN="V2QS8" VTYPE="70" VTYPE_TEXT="General Cargo" SIZE_A="77" SIZE_B="11" SIZE_C="6" SIZE_D="7" DRAUGHT="5.7" FLAG="AG" FLAG_MID="304" GRT="2450" DWT="3713" YEAR_BUILT="1994" DESTINATION="ES CAS" ETA="2019-02-22T15:00:00" CURRENT_PORT="" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCO="" CURRENT_PORT_COUNTRY="" CURRENT_PORT_ARR="" CURRENT_PORT_ARR_LT="" LAST_PORT="SAVONA" LAST_PORT_ID="373" LAST_PORT_UNLOCO="ITSVN" LAST_PORT_COUNTRY="Italy" LAST_PORT_DEP="2019-02-06T18:27:40" LAST_PORT_DEP_LT="2019-02-06T19:27:40" NEXT_PORT="CASTELLON" NEXT_PORT_ID="1923" NEXT_PORT_UNLOCO="ESCAS" NEXT_PORT_COUNTRY="Spain" NEXT_PORT_ETA="2019-02-23T08:37:42" NEXT_PORT_ETA_LT="2019-02-23T09:37:42" AVG_SOG="9.5" MAX_SOG="12" DISTANCE_COVERED="1449.26" WIND_KNOTS="27" WIND_DIRECTION="NNE" HUMIDITY="71.1" PRESSURE="1024.7" TEMPERATURE="12" CLOUD_COVERAGE="90" PRECIPITATION="0" VISIBILITY="22500" />
<POS MMSI="368886000" IMO="9677569" LAT="35.50539" LNG="24.10936" HEADING="319" COURSE="319" SPEED="0" ROT="0" TIMESTAMP="2019-02-17T08:44:07" SRC="SAT" NAME="YUMA" CALLSIGN="NYMA" VTYPE="40" VTYPE_TEXT="High speed craft" SIZE_A="39" SIZE_B="64" SIZE_C="28" SIZE_D="1" DRAUGHT="4.2" FLAG="US" FLAG_MID="368" GRT="" DWT="" YEAR_BUILT="" DESTINATION="0" ETA="" CURRENT_PORT="SOUDA" CURRENT_PORT_ID="8" CURRENT_PORT_UNLOCO="GRSDH" CURRENT_PORT_COUNTRY="Greece" CURRENT_PORT_ARR="2019-02-16T06:33:51" CURRENT_PORT_ARR_LT="2019-02-16T08:33:51" LAST_PORT="RIJEKA" LAST_PORT_ID="355" LAST_PORT_UNLOCO="HRRJK" LAST_PORT_COUNTRY="Croatia" LAST_PORT_DEP="2019-02-07T08:24:29" LAST_PORT_DEP_LT="2019-02-07T09:24:29" NEXT_PORT="" NEXT_PORT_ID="" NEXT_PORT_UNLOCO="" NEXT_PORT_COUNTRY="" NEXT_PORT_ETA="" NEXT_PORT_ETA_LT="" AVG_SOG="" MAX_SOG="" DISTANCE_COVERED="" WIND_KNOTS="13" WIND_DIRECTION="NNE" HUMIDITY="81.5" PRESSURE="1023.5" TEMPERATURE="9.5" CLOUD_COVERAGE="100" PRECIPITATION="0.8" VISIBILITY="13300" />
</VESSEL>
https://api.myshiptracking.com/vesselsinarea/v:1/apikey:YOUR-API-KEY/src:sat/format:json/minlat:35.2276723/maxlat:36.20184/minlon:20.747680/maxlon:24.34570/timespan:10
[
{
"MMSI": 352914000,
"IMO": 9302748,
"LAT": "36.05562",
"LNG": "24.24736",
"HEADING": 102,
"COURSE": 109,
"SPEED": 11.8,
"ROT": 0,
"TIMESTAMP": "2019-02-17T09:04:24",
"SRC": "TER"
},
{
"MMSI": 667001713,
"IMO": 8917742,
"LAT": "35.27814",
"LNG": "22.22928",
"HEADING": 242,
"COURSE": 242.2,
"SPEED": 11.4,
"ROT": 0,
"TIMESTAMP": "2019-02-17T08:52:31",
"SRC": "SAT"
},
{
"MMSI": 636018296,
"IMO": 9222986,
"LAT": "36.00333",
"LNG": "22.55667",
"HEADING": 273,
"COURSE": 273,
"SPEED": 20,
"ROT": 0,
"TIMESTAMP": "2019-02-17T08:48:52",
"SRC": "SAT"
},
{
"MMSI": 304138000,
"IMO": 9006382,
"LAT": "36.07003",
"LNG": "23.20135",
"HEADING": 237,
"COURSE": 232.9,
"SPEED": 8.2,
"ROT": 0,
"TIMESTAMP": "2019-02-17T08:48:28",
"SRC": "SAT"
}
]