SVMP와 달라진 주요 기능, 필드명 변경, API 구조 개선사항 등을 정리하였으며, 전환에 필요한 기술적 대응과 테스트 절차를 단계별로 제공합니다.
개선 사항
1. UI/UX 개선
•
SaaS 서비스를 사용할 경우, 워크스페이스에 등록된 전체 선박 목록을 한눈에 확인할 수 있습니다.
•
SVMP 사용자들이 기존과 동일한 사용 경험을 유지할 수 있도록, UI를 SVMP 기준으로 표준화하였습니다.
2. Ship name 라벨 추가
•
선박 아이콘 아래에 선명을 함께 표시하는 기능이 추가되어, 지도에서 쉽게 선박 식별을 할 수 있습니다.
3. 선박 위치 기준 지도 확대 기능
•
메뉴 클릭 시 해당 메뉴에 포함된 선박 위치 기준으로 화면이 확대됩니다.
4. Fleet API 추가 및 개선
•
선박 제원과 PTA만 조회할 수 있는 신규 API가 새롭게 추가되었습니다.
•
AIS 정보만 조회할 수 있는 API를 추가하여, 경량화된 데이터 조회가 가능해졌습니다.
•
Fleet 메뉴에서 선박 등록 시, 단건 등록만 가능했던 방식에서 일괄 등록이 가능하도록 개선하였습니다.
•
단건 선박 정보를 조회할 때, 선박을 사전에 등록하지 않아도 즉시 조회가 가능하도록 개선하였습니다.
(단, 이미 등록이 완료된 선박에 대해서는 일괄 조회를 제공합니다.)
5. 운항 선사 선박 스케줄 조회 API 추가
•
컨테이너 선박의 IMO 번호를 통해 해당 선박의 운항 선사 스케줄 정보를 조회할 수 있습니다.
•
이를 통해 스케줄 변경이나 지연, 기항 순서 변경 등의 정보를 신속하게 파악할 수 있습니다.
6. 속도 개선
•
전반적인 속도를 개선하여 로딩 시간을 단축하였습니다.
7. 메일링 서비스
•
선박, 화물, 또는 항구와 관련된 사고가 발생해 배송에 영향을 미칠 가능성이 있는 경우, 사고 세부 정보가 포함된 이메일이 발송됩니다.
•
이를 통해 잠재적인 장애를 조기에 감지하고, 추가 피해를 방지하기 위한 신속한 후속 조치를 취할 수 있습니다.
변경 사항
•
SVMP에서 사용하던 My Fleet 개념은 SeaVantage Insight에서는 즐겨찾기(Favorite)로 변경되었습니다.
•
Company Filter는 Fleet으로 개편되어, 워크스페이스의 선박 메뉴를 효율적으로 관리할 수 있습니다.
•
참고로 기존 SVMP My Fleet은 API 연계 계정 전용 기능이며, SeaVantage Insight에서는 Fleet으로 선박 등록을 진행해 주세요.
1. API 변경
API | SVMP | SeaVantage Insight |
[GET] /ship/search | https://svmp.seavantage.com/api/v1/ship/search | https://insight.seavantage.com/api/ship/search |
[GET] /fleet/snapshot | https://svmp.seavantage.com/api/v1/ship/snapshot | https://insight.seavantage.com/api/fleet/snapshot |
[GET] /fleet | https://svmp.seavantage.com/api/v1/company/custom/filter/ship/menulist | https://insight.seavantage.com/api/fleet |
[DELET] /fleet | https://svmp.seavantage.com/api/v1/company/custom/filter/ship/mapper/delete | https://insight.seavantage.com/api/fleet |
[POST] /fleet | https://svmp.seavantage.com/api/v1/company/custom/filter/save | https://insight.seavantage.com/api/fleet |
[GET] /fleet/categories | https://svmp.seavantage.com/api/v1/company/custom/filter
파라미터: menuType값 S 입력 | https://insight.seavantage.com/api/fleet/categories |
[GET] /port-call/{shipId} | https://svmp.seavantage.com/api/v1/ship/{shipId}/portCall | https://insight.seavantage.com/api/port-call/{shipId} |
[GET] /ship/past-track | https://svmp.seavantage.com/api/v1/ship/{shipId}/pastTrack | https://insight.seavantage.com/api/ship/past-track |
[GET] /ship/past-track/from-last-port | https://svmp.seavantage.com/api/v1/ship/{shipId}/pastTrack/fromLastPort | https://insight.seavantage.com/api/ship/past-track/from-last-port |
2. 신규 API
API | SeaVantage Insight | 설명 |
[DELETE] /ship | https://insight.seavantage.com/api/ship | 워크스페이스에서 사용중인 선박을 삭제합니다.
(모든 계정의 즐겨찾기 및 메뉴에 등록/미등록 상관없이 사용중인 전체 선박을 삭제합니다.) |
[GET] /fleet/info | https://insight.seavantage.com/api/fleet/info | 선박 제원 및 PTA를 조회합니다. |
[GET] /voyage/schedule | https://insight.seavantage.com/api/voyage/schedule | 선박 스케줄 정보를 조회합니다. |
3. 신규 필드 추가 및 명칭 변경
•
명확한 의미 전달을 위해 일부 필드명이 변경 되었습니다.
•
API 용도에 맞춰 응답 구조를 단순화하여 일부 필드가 삭제되었습니다.
•
정확한 목적지 예측을 돕기 위해 관련 필드가 추가되었습니다.
•
상세한 내용은 아래 필드 추가 사항을 참고해 주세요.
3-1. [GET] /ship/search API 필드 추가 및 명칭 변경
response 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
shipAliasName | 필드명 삭제 | |
shipTypeCargo | 필드명 삭제 | |
shipImage | 필드명 삭제 | |
hullType | 필드명 삭제 | |
gt | 필드명 삭제 | |
destination | 필드명 삭제 | |
eta | 필드명 삭제 | |
shipStatusType | 필드명 삭제 | |
builtBy | 필드명 삭제 | |
builtAt | 필드명 삭제 | |
loa | 필드명 삭제 | |
depth | 필드명 삭제 | |
maxDraught | 필드명 삭제 | |
engineBuiltBy | 필드명 삭제 | |
designedBy | 필드명 삭제 | |
serviceSpeed | 필드명 삭제 | |
useYn | 필드명 삭제 |
position 객체 필드 변경 사항
•
API 용도에 맞춰 응답 구조를 단순화하여 전체 필드 삭제
3-2. [GET] /fleet/snapshot API 필드 추가 및 명칭 변경
•
•
SeaVantage Insight Swagger 문서 바로가기
response 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
imoNo | 필드명 삭제 | |
mmsi | 필드명 삭제 | |
callSign | 필드명 삭제 | |
shipName | 필드명 삭제 | |
shipAliasName | 필드명 삭제 | |
shipType | 필드명 삭제 | |
shipTypeBySize | 필드명 삭제 | |
shipTypeCargo | 필드명 삭제 | |
shipImage | 필드명 삭제 | |
built | 필드명 삭제 | |
dwt | 필드명 삭제 | |
hullType | 필드명 삭제 | |
gt | 필드명 삭제 | |
destination | 필드명 삭제 | |
eta | 필드명 삭제 | |
shipStatusType | 필드명 삭제 | |
builtBy | 필드명 삭제 | |
builtAt | 필드명 삭제 | |
loa | 필드명 삭제 | |
depth | 필드명 삭제 | |
maxDraught | 필드명 삭제 | |
engineBuiltBy | 필드명 삭제 | |
designedBy | 필드명 삭제 | |
serviceSpeed | 필드명 삭제 | |
nationCode | 필드명 삭제 | |
useYn | 필드명 삭제 | |
breadth | 필드명 삭제 | |
teuCapacity | 필드명 삭제 | |
liquidCapacity | 필드명 삭제 |
position 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
callsSign | callSign | 필드명 변경 |
siteShip 객체 필드 변경 사항
•
불필요한 전체 필드 삭제
3-3. [GET] /fleet API 필드 추가 및 명칭 변경
response 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
deleteEnable | 필드명 삭제 | |
categoryIds | 메뉴별 관리를 위한 관련 필드 추가 |
ship 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
shipImage | 필드명 삭제 | |
destination | destinationUnlocode | 필드명 변경 |
eta | pta | 필드명 변경 |
shipStatusType | 필드명 삭제 | |
useYn | 필드명 삭제 | |
destinationPortId | 목적지 예측 관련 필드 추가 | |
ptb | 목적지 예측 관련 필드 추가 | |
destinationTerminalName | 목적지 예측 관련 필드 추가 | |
destinationPortName | 목적지 예측 관련 필드 추가 |
position 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
callsSign | callSign | 필드명 변경 |
siteShip 객체 필드 변경 사항
•
API 용도에 맞춰 응답 구조를 단순화하여 전체 필드 삭제
3-4. [DELETE] /fleet API 필드 추가 및 명칭 변경
응답 정보 변경 사항
•
성공 했을 경우
◦
SVMP에서 삭제한 선박 외 등록된 선박 데이터를 반환하던 방식에서, HTTP Status: 204 No Content만 반환하고 Response Body는 제공되지 않도록 변경되었습니다.
•
실패 했을 경우
SVMP | SeaVantage Insight | 변경 내용 |
error_message | 필드명 삭제 | |
response | 필드명 추가
(응답 성공과 동일한 포맷으로 구성) |
3-5. [POST] /fleet API 필드 추가 및 명칭 변경
응답 정보 변경 사항
•
성공 했을 경우
◦
SVMP에서 등록 요청한 선박 데이터를 반환하던 방식에서, HTTP Status: 204 No Content만 반환하고 Response Body는 제공되지 않도록 변경되었습니다.
•
실패 했을 경우
SVMP | SeaVantage Insight | 변경 내용 |
error_message | 필드명 삭제 | |
response | 필드명 추가
(응답 성공과 동일한 포맷으로 구성) |
3-6. [GET] /fleet/categories API 필드 추가 및 명칭 변경
response 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
menuId | 필드명 삭제 | |
parentId | 필드명 삭제 | |
menuName | 필드명 삭제 | |
menuLevel | 필드명 삭제 | |
updtDt | 필드명 삭제 | |
updusrId | 필드명 삭제 | |
registDt | 필드명 삭제 | |
registerId | 필드명 삭제 | |
staticLevel | 필드명 삭제 | |
sortSn | 필드명 삭제 | |
menuType | 필드명 삭제 | |
fleetCategoryId | 필드명 추가 | |
categoryName | 필드명 추가 | |
parentCategoryName | 필드명 추가 | |
includeShipsCount | 필드명 추가 |
3-7. [GET] /port-call/{shipId} API 필드 추가 및 명칭 변경
ship 객체 필드 변경 사항
•
API 용도에 맞춰 응답 구조를 단순화하여 전체 필드 삭제
portCalls 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
arrivalAnchId | 필드명 삭제 | |
arrivalBerthId | 필드명 삭제 |
departurePort, arrivalPort 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
portAlias | 필드명 삭제 | |
geoData | 필드명 삭제 | |
useYn | 필드명 삭제 | |
usePortInsight | 필드명 삭제 | |
portShipType | 필드명 삭제 |
3-8. [GET] /ship/past-track API 필드 추가 및 명칭 변경
ship 객체 필드 변경 사항
•
API 용도에 맞춰 응답 구조를 단순화하여 전체 필드 삭제
trackData 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
callsSign | callSign | 필드명 변경 |
3-9. [GET] /ship/past-track/from-last-port API 필드 추가 및 명칭 변경
•
•
SeaVantage Insight Swagger 문서 바로가기
ship 객체 필드 변경 사항
•
API 용도에 맞춰 응답 구조를 단순화하여 전체 필드 삭제
trackData 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
callsSign | callSign | 필드명 변경 |
SVMP 데이터 이관
데이터 이관은 당사 기준으로 약 30분 정도 소요되며, 원활한 진행을 위해 고객사 가능 시간을 사전에 협의해 주시기 바랍니다. 일정 확정 및 세부 조율은 sales@seavantage.com로 연락 부탁드립니다.