1. Latest GPS data (All)

이 API는 사용자가 관리하는 모든 선박의 가장 최신 GPS 데이터를 제공합니다.

선박에 대한 GPS 데이터 정보는 DAQ mini를 통해 수집되는 데이터이며 Vessellink DB를 통해 수신됩니다.

This API provides the latest GPS data of all user-managed vessels.

DAQ mini on the user-managed vessels collects GPS data from the installed vessels. The GPS data of the vessel is provided through Vessellink DB.

USE OUR WIZARD TO TRY OUT THIS ENDPOINT ➜

1.1 Request

Parameter	Description	Type
N/A	-	-

1.2 Response

{
    "meta": {
        "code": 200,
        "message":"Ok",
        "time": "2023-06-20T13:00:00Z",
        "count": 1,
    },
    "datas": [{
      	"imoNo": "9982722",
      	"timeStamp":"2023-06-20T13:00:00Z",
      	"speedVg":0.057,
      	"courseOverGround":234.725,
      	"lat": 129.4034,
      	"lon": 36.024
    }]
}

Field	Description	Unit
`meta`-`code`	Response code	integer
`meta`-`message`	Response message	string
`meta`-`time`	API call time	datetime
`meta`-`count`	Response data count	integer
`datas`-`imoNo`	IMO identifier of vessel	long
`datas`-`timeStamp`	Latest time of the gps data (UTC)	(string) ISO 8601 date
`datas`-`speedVg`	Current vessel speed over ground in knots (SOG)	float
`datas`-`courseOverGround`	Current vessel course in degrees	float
`datas`-`lat`	Current vessel latitude	(float) ISO 6709 (decimal point)
`datas`-`lon`	Current vessel longitude	(float) ISO 6709 (decimal point)

2. Latest GPS data (Ship)

관리하는 개별 선박에 대한 가장 최신 GPS 데이터를 제공합니다.

This API provides the latest GPS data of individual selected vessels.

USE OUR WIZARD TO TRY OUT THIS ENDPOINT ➜

2.1 Request

Parameter	Description	Type
imoNumber	IMO identifier of vessel	long

2.2 Response

{
    "meta": {
        "code": 200,
        "message":"Ok",
        "time": "2023-06-20T13:00:00Z",
        "count": 1,
    },
    "datas": [{
      	"imoNo": "9982722",
      	"timeStamp":"2023-06-20T13:00:00Z",
      	"speedVg":0.057,
      	"courseOverGround":234.725,
      	"lat": 129.4034,
      	"lon": 36.024
    }]
}

Field	Description	Unit
`meta`-`code`	Response code	integer
`meta`-`message`	Response message	string
`meta`-`time`	API call time	datetime
`meta`-`count`	Response data count	integer
`datas`-`imoNo`	IMO identifier of vessel	long
`datas`-`timeStamp`	Latest time of the gps data (UTC)	(string) ISO 8601 date
`datas`-`speedVg`	Current vessel speed over ground in knots (SOG)	float
`datas`-`courseOverGround`	Current vessel course in degrees	float
`datas`-`lat`	Current vessel latitude	(float) ISO 6709 (decimal point)
`datas`-`lon`	Current vessel longitude	(float) ISO 6709 (decimal point)

3. Timeline GPS data

원하는 선박 별로 최신 GPS 데이터 시점을 기준으로 일정 기간(1h. 3h, 6h, 12h, 1d)을 설정 Timeline 형태로 GPS 데이터를 받을 수 있습니다.

예시)

조회 시점 : 2023.06.22 12:00 (UTC)
Timeline set : 1d
조회 데이터 : 2023.06.21 12:00(UTC) ~ 2023.06.22 12:00(UTC)

This API provides the timeline GPS data of individual selected vessels.

User can receive GPS data in a timeline format for the selected vessels, based on a specified time period (1h, 3h, 6h, 12h, 1d) using the latest GPS data point as a criteria.

example)

Query Timestamp : 2023.06.22 12:00 (UTC)
Timeline set : 1d
Query data period: 2023.06.21 12:00(UTC) ~ 2023.06.22 12:00(UTC)

USE OUR WIZARD TO TRY OUT THIS ENDPOINT ➜

3.1 Request

Parameter	Description	Type
imoNumber	IMO identifier of vessel	long
timeSteps	Timeline (1,3,6,12,24)	integer

3.2 Response

{
    "meta": {
        "code": 200,
        "message":"Ok",
        "time": "2023-06-20T13:00:00Z",
        "count": 2,
    },
    "datas": [{
      	"imoNo": "9982722",
      	"timeStamp":"2023-06-20T13:00:00Z",
      	"speedVg":0.057,
      	"courseOverGround":234.725,
      	"lat": 129.4034,
      	"lon": 36.024
    },{
      	"imoNo": "9982722",
      	"timeStamp":"2023-06-20T13:10:00Z",
      	"speedVg":0.057,
      	"courseOverGround":234.725,
      	"lat": 129.5034,
      	"lon": 36.124
    }]
}

Field	Description	Unit
`meta`-`code`	Response code	integer
`meta`-`message`	Response message	string
`meta`-`time`	API call time	datetime
`meta`-`count`	Response data count	integer
`datas`-`imoNo`	IMO identifier of vessel	long
`datas`-`timeStamp`	Latest time of the gps data (UTC)	(string) ISO 8601 date
`datas`-`speedVg`	Current vessel speed over ground in knots (SOG)	float
`datas`-`courseOverGround`	Current vessel course in degrees	float
`datas`-`lat`	Current vessel latitude	(float) ISO 6709 (decimal point)
`datas`-`lon`	Current vessel longitude	(float) ISO 6709 (decimal point)