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. Other

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 

Ship Types in Database

Ship Types in Database

Datalastic offers a detailed, extensive vessel information database that covers a very large variety of ship types. We aim to make sure you will find the exact type of vessel information using the database that is available either for one-time download or can or as...

Top 5 Maritime News, Blogs & Magazines

Top 5 Maritime News, Blogs & Magazines

The following list of the best maritime magazines, news, and blog providers is independent and it is selected by Datalastic opinion. Datalastic doesn't own or does not have any formal relationship with any of the mentioned news providers. The following magazines do...

Maritime Data Quality

Maritime Data Quality

Maritime data quality is the key question for any database provider. How to make sure that the vessel data provided is reliable, frequent, and serves the needs in the maritime industry. What is Maritime Data? Maritime data is big data information collected from...

How to Get Maritime Traffic Data?

How to Get Maritime Traffic Data?

Datalastic REST API web services contain historical maritime information, real-live marine traffic overview and future ships traffic forecast.

How to Start Using Datalastic Maritime API in 5 Steps

How to Start Using Datalastic Maritime API in 5 Steps

This is your brief guide to start using maritime data API services by Datalastic.What is maritime API by Datalastic? Maritime data REST API is explained very well in the video below. Datalastic REST API web services work in a similar way. We own a vessel and ports...

Maritime API in Mobile Apps Examples

Maritime API in Mobile Apps Examples

Maritime data and ship position data are very dynamic and therefore it is hard to collect and store it. That is why many apps prefer to simply use maritime API to connect to the databases about ships and port information.  Hereon you will see the use cases of API in...