5 Types of Data Endpoints in Datalastic Maritime API

Mar 5, 2021 | Maritime API

5 types of Datalastic Data Endpoints

Datalastic provides multiple maritime data endpoints that allow you to retrieve the data from the Datalastic database and further use it for data analysis, applications, software, platforms, and so on.

 

Datalastic Endpoints:

  1. Vessel Information API
  2. Maritime Port information API
  3. Ship Real-time tracking API
  4. Zone vessel traffic API
  5. Ship Historical Data API

Vessel Information API Endpoint

With this endpoint, users can access data about ships such as vessel MMSI, IMO, country name, call-sign, ship type and subtype, sip gross tonnage, deadweight, TEU, length, breadth, year built, and home port, liquid gas on board, quantity.

Datalastic has more than 306 vessel types and subtypes which allows users to understand the vessels with great precision.

See a typical vessel information data output on the right.

See here your typical request where “MMSI”, “IMO” and “UUID” are numbers of a vessel:

https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&uuid=b8625b67-7142-cfd1-7b85-595cebfe4191
https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&mmsi=566093000
https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&imo=9525338

Here is a typical response to the data requested:

{
    "data": {
        "uuid": "b8625b67-7142-cfd1-7b85-595cebfe4191",
        "name": "MAERSK CHENNAI",
        "name_ais": "MAERSK CHENNAI",
        "mmsi": "566093000",
        "imo": "9525338",
        "eni": null,
        "country_iso": "SG",
        "country_name": "Singapore",
        "callsign": "9V9409",
        "type": "Cargo - Hazard A (Major)",
        "type_specific": "Container Ship",
        "gross_tonnage": 50869,
        "deadweight": 61614,
        "teu": "4500",
        "liquid_gas": null,
        "length": 249.12,
        "breadth": 37.4,
        "year_built": "2011",
        "is_navaid": false,
        "home_port": null
    },
    "meta": {
        "duration": 0.008994512
        "endpoint": "/api/v0/vessel_info",
        "success": true
    }
}
vessel information api endpoint

Maritime Port information API Endpoint

See all the data about marine ports and view information that is essential to you. With Maritime Port information endpoint you will access data about port name, country ISO, country name of that port, unlocode, port type, location (longitude and latitude) and 2 area levels as in the example.

Your typical request:

https://api.datalastic.com/api/v0/port_find?api-key={YOUR_API_KEY}&name=rotterdam

Here is a typical response to the marine ports data requested:

{
 {
    "data": [
        {
            "uuid": "37a8ac5b-d126-d7ce-9aca-7b8249c2efd2",
            "port_name": "ROTTERDAM",
            "country_iso": "NL",
            "country_name": "Netherlands",
            "unlocode": "NLRTM",
            "port_type": "Port",
            "lat": 	51.94331,
            "lon": 4.141812,
            "area_lvl1": "UK Coast & Atlantic",
            "area_lvl2": "Rotterdam Area"
        },
    ],
    "meta": {
        "duration": 0.060431033,
        "endpoint": "/api/v0/port_find",
        "success": true
    }
}
marine ports information api endpoint

Ship Real-time tracking API Endpoint

With this endpoint, customers can view the current position of the vessels, UUID, Name of the vessel, IMO, MMSI numbers, country ISO, type and subtype of the vessel, current longitude and latitude, speed, course, heading, navigational status, destination and the timestamp of the last position reported.

Your typical request:

https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&uuid=b8625b67-7142-cfd1-7b85-595cebfe4191
https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&mmsi=566093000
https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&imo=9525338

Here is a typical response to the marine ports data requested:

{
    "data": {
        "uuid": "b8625b67-7142-cfd1-7b85-595cebfe4191",
        "name": "MAERSK CHENNAI",
        "mmsi": "566093000",
        "imo": "9525338",
        "eni": null,
        "country_iso": "SG",
        "type": "Cargo - Hazard A (Major)",
        "type_specific": "Container Ship",
        "lat": 35.88855,
        "lon": -5.499166,
        "speed": 0.1,
        "course": 214,
        "navigational_status": "Under Way using engine"" 
        "heading": 44,
        "destination": "MAPTM>ATSEA",
        "last_position_epoch": 1614900540,
        "last_position_UTC":"2021-03-04T23:29:00Z"
    },
    "meta": {
        "duration": 0.009448773,
        "endpoint": "/api/v0/vessel",
        "success": true
    }
}
Real Time Ship data API endpoint

Zone vessel traffic API Endpoint

In case that you don’t need to monitor a specific vessel but you are rather interested in an area to be supervised, then you have a zone vessel traffic monitoring option. Just define the location you need and the radius around and start seeing all vessel traffic coming to that area.

Your typical request:

https://api.datalastic.com/api/v0/vessel_inradius?api-key={YOUR_API_KEY}&lat=29.15915&lon=-89.25454&radius=3
https://api.datalastic.com/api/v0/vessel_inradius?api-key={YOUR_API_KEY}&mmsi=566093000&radius=5

Here is a typical response to the marine ports data requested:

As you see we found 14 ships in a radius of 3 in a certain location defined by longitude and latitude. For this article, we are going to put a screenshot only of 1 vessel instead of 14 to make it more compact.

{
    "data": {
        "point": {
            "lat": 29.15915,
            "lon": -89.25454,
            "radius": 3
        },
        "total": 14,
        "vessels": [
            {
                "uuid": "1964bb6e-ec2e-5fe3-911b-69a2ca339b6c",
                "name": "LAYLA RENEE",
                "mmsi": "367430840",
                "imo": "null",
                "eni": null,
                "country_iso": "US",
                "type": "Tug",
                "type_specific": "Tug",
                "lat": 29.15903,
                "lon": -89.24783,
                "speed": 0,
                "course": 291,
                "heading": 291,
                "destination": "HEAD OFF",
                "last_position_epoch": 1615046400,
                "last_position_UTC": "2021-03-06T16:00:00Z",
                "distance": 0.351893014470194
            }
Zone Marine traffic API endpoint

Excel Static Databases

In case you need only a static database with Vessel or Ports information, sometimes getting an excel or CSV file also pays off, the upside of this option is that it is a one-time payment and you access data in a very familiar format: Excel, downside tho is that this vessel data with time become outdated and you would need to redownload the file manually. Using API the vessel and Port data is always maintained up to date with the latest standards. 

You can see a full static Excel database offering on our website

Full Vessel Static database in Excel to download Example

Read Other Maritime Articles 

Flight API

Flight API

Access real-time, historical and future dates flight API to get flight status, location, delay, route data and more. Flight APIs of Aviation Edge are useful data tools for developers with global flight data and uptime rates of 99.9%.   Flight Tracking: Keep tabs...

Flight Tracker API

Flight Tracker API

Get real-time aircraft location and speed data with Aviation Edge Flight Tracker API. The flight tracking data allows you to monitor an aircraft’s real-time location, speed, and status throughout its route. The API uses REST which allows a clear and simple integration...

Flight Schedules API

Flight Schedules API

Flight Schedules API developed by Aviation Edge provides real-time, historical and future airport timetable data. Track departure and arrival schedules of airports worldwide. Alternatively, use an airline filter to track an airline’s flight schedule.   Flight number  ...

Why the Maritime API is a Must-Have?

Why the Maritime API is a Must-Have?

Maritime API, a revolution in the shipping and logistics sector, have transformed the way businesses in this industry operate. They grant access to a wealth of data about ships, their journeys, and intricate details that can be leveraged to streamline operations....

Find Ships In New York Port

Find Ships In New York Port

Finding ships in the New York Port is akin to tapping into the pulse of global commerce. Serving as the eastern gateway to the U.S., the NYC port is a bustling hub of trade. Its terminals show how important it is for worldwide links. In this article, we will identify...

Find 15 Major Maritime Ports in the World with API

Find 15 Major Maritime Ports in the World with API

Find major ports with API: In the world of maritime transportation, ports play a crucial role as key hubs for global trade and commerce. Identifying the major ports is essential for various stakeholders, including shipping companies, logistics providers, and port...