The Open Ship Data API offers versatile marine vessel features search that allows to interchange data from vessels such as location, speed and destination. The following endpoints are available:
- find ships in an area, moving or still
- lookup specific ships
- get planned arrivals in an area
All coordinates are in WGS84.
API
Find ships in area GET http://ais.marineplan.com/api/location/<version>/locations.json?<parameters>
Parameters
| parameter | description | values | default value |
|---|---|---|---|
| version | API version | 1 | |
| area | WGS84 SW latitude, longitude; NE latitude, longitude | – | |
| maxage | maximum data age in seconds | 0 reflects any age | 1800 |
| moving | filter for moving or still ships | 0=still ships 1=moving ships | 1 |
| API-key | API secret key, to be requested from MarinePlan | string | – |
Response
The response contains:
{
"reports": [{
"timeSecUtc": 1582790271,
"point": {
"latitude": 52.37547,
"longitude": 4.90628
},
"destination": {
"latitude": 52.37547,
"longitude": 4.90628
},
"destinationName": "Amsterdam",
"etaSecUtc": 1582793222,
"boatName": "Albert",
"callSign": "PF6426",
"mmsi": "244013483",
"lengthMeters": 16.0,
"widthMeters": 3.0,
"heightMeters": 0.0,
"captain": "",
"speedKmh": 8.89,
"bearingDeg": 306.5,
"vesselType": "YACHT",
"source": "AIS",
"boundingBox": {
"topLeft": {
"latitude": 52.375515,
"longitude": 4.906206
},
"bottomRight": {
"latitude": 52.375425,
"longitude": 4.906354
}
}
}, {
"timeSecUtc": 1582790284,
"point": {
"latitude": 52.3764,
"longitude": 4.89744
},
"destinationName": "",
"etaSecUtc": 0,
"boatName": "Pax",
"callSign": "PG5061",
"mmsi": "244780654",
"lengthMeters": 18.0,
"widthMeters": 4.0,
"heightMeters": 0.0,
"captain": "",
"speedKmh": 0.56,
"bearingDeg": 360.0,
"vesselType": "YACHT",
"source": "AIS",
"boundingBox": {
"topLeft": {
"latitude": 52.376445,
"longitude": 4.897366
},
"bottomRight": {
"latitude": 52.376355,
"longitude": 4.897514
}
}
}, {
"timeSecUtc": 1582790298,
"point": {
"latitude": 52.37099,
"longitude": 4.88808
},
"destinationName": "Amsterdam",
"etaSecUtc": 0,
"boatName": "Iris",
"callSign": "PC9987",
"mmsi": "244820333",
"lengthMeters": 16.0,
"widthMeters": 3.0,
"heightMeters": 0.0,
"captain": "",
"speedKmh": 0.56,
"bearingDeg": 191.9,
"vesselType": "YACHT",
"source": "AIS",
"boundingBox": {
"topLeft": {
"latitude": 52.371035,
"longitude": 4.888006
},
"bottomRight": {
"latitude": 52.370945,
"longitude": 4.888154
}
}
}, {
"timeSecUtc": 1582790215,
"point": {
"latitude": 52.37179,
"longitude": 4.88177
},
"destinationName": "A'dam",
"etaSecUtc": 0,
"boatName": "Rebel",
"callSign": "PB4903",
"mmsi": "244615787",
"lengthMeters": 6.0,
"widthMeters": 2.0,
"heightMeters": 0.0,
"captain": "",
"speedKmh": 6.85,
"bearingDeg": 64.7,
"vesselType": "CONSOLE_BOAT",
"source": "AIS",
"boundingBox": {
"topLeft": {
"latitude": 52.371835,
"longitude": 4.881696
},
"bottomRight": {
"latitude": 52.371745,
"longitude": 4.881844
}
}
}]
}
