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 

The Different Hazard Levels Through Ship API

The Different Hazard Levels Through Ship API

Assigning hazard levels to pressure vessels, is a way to warn about the potential hazard created. Those levels are determined by the AS 43434:2014 standards state, and these ratings act as essential warnings. We will find out in this article what are the different...

Vessel API: Access Data Instantly

Vessel API: Access Data Instantly

Having vessel data and unlocking the potential of the application programming interface (API) has been the developers' goldmine for a while. It is not often simple to get access to vessel API and ship data as maritime data providers tend to be secretive about the...

DWT VS TEU

DWT VS TEU

This article covers the importance of Deadweight ‘DWT’ and TEU measurements. Monitoring these values has led to increased cargo lift capacity and an improved tonne per mile ride coefficient rate. Nowadays these study cases are parts of the EU and Worldwide Maritime...

The Power Of The Maritime Data Analytics

The Power Of The Maritime Data Analytics

In this era, with the fast-paced world, maritime analytics becomes a big world instead of a reference. From business owners to developers to the amateur become interested to know about everything related to the marine traffic industry, vessel movements, types,...

How To Track Your Container With API

How To Track Your Container With API

Containers ship tracking is a necessary function when it comes to supply chain management. Following the status of your container, all day through a hundred emails and messages can be exhausting sometimes especially if you have a big number of containers, it’s...

International Sea Routes for Navigation

International Sea Routes for Navigation

International Sea Routes for Navigation:   This is a list of international Routes:  1:South Atlantic Oceanic Route  2:North Atlantic Oceanic Route 3:Routes of the Mediterranean Sea 4:Cape of Good Hope route 5:North Pacific Oceanic Route 6:South Pacific Oceanic...