World Port Data

세계 각 국가에 위치한 포트 코드 정보입니다. 유엔 기구인 UNECE에서 발간하는 정보, 해운사 인터뷰, 인터넷에서 수집한 항만 정보를 전문가 검증을 통해 정리하였습니다. 239개 국가 및 103,034개의 지역이 포함되어 있으며, 공간 쿼리를 통해 원하는 지역에 근접한 항만 정보를 확인할 수 있습니다.

Data Name

World Port Data

BASE URL PATH

https://api.vessellink.com/v1/worldPort

DATA COVERAGE

Global

Spatial Search

1. Spatial Search

USE OUR WIZARD TO TRY OUT THIS ENDPOINT ➜

1.1 Request Parameter

curl --request GET \
     --url 'https://data.vessellink.com/v1/worldPort?radius=56.4' \
     --header 'Accept: application/json'

Parameter	Description	Type
`lat`	Find port in a circle area of defined latitude as a center	(float) ISO 6709 (decimal point)
`long`	Find port in a circle area of defined longitude as a center	(float) ISO 6709 (decimal point)
`radius`	Radius around that defined center (lat, long) in NM	(float) max 500NM

1.2 API Response

{
    "meta": {
        "code": 200,
        "lat": 32.1,
        "long": 123.45,
        "radius": 100,
        "portCount": 2
    },
    "port": [
        {
            "portName": "Busan new port, Korea",
            "lat": 34.1,
            "long": 123.3,
            "country": "Korea",
            "locode": "KRBUS",
            "timeZone": -9.5
        },
        {
            "portName": "Kwangyang, Korea",
            "lat": 33.4,
            "long": 121.2,
            "country": "Korea",
            "locode": "KRKAN",
            "timeZone": -9
        }
    ]
}

Field	Description	Unit
`meta` - `code`	Response code	integer
`meta` - `lat`	Find port in a circle area of defined latitude as a center	(float) ISO 6709 (decimal point)
`meta` - `long`	Find port in a circle area of defined longitude as a center	(float) ISO 6709 (decimal point)
`meta` - `radius`	Radius around that defined center (lat, long) in NM	(float) max 500NM
`meta` - `portCount`	Number of the port requested	integer
`port` - `portName`	Port name (usually matches name from UN/LOCODE, World Port Index or other publications).	string
`port` - `lat`	Latitude of port	(float) ISO 6709 (decimal point)
`port` - `long`	Longitude of port	(float) ISO 6709 (decimal point)
`port` - `country`	Country code in ISO 3166-1 alpha-2 format. Can be an empty string or null if unknown.	string
`port` - `locode`	UN/LOCODE. Can be empty string if not applicable or unknown.	string
`port` - `timeZone`	Timezone of Port	(float) -14 ~ +14