home

Port Insight 전환 가이드

SVMP와 달라진 주요 기능, 필드명 변경, API 구조 개선사항 등을 정리하였으며, 전환에 필요한 기술적 대응과 테스트 절차를 단계별로 제공합니다.

개선 사항

1. UI/UX 개선

•
디자인시스템을 구축하여 텍스트 & 컬러 스타일, 컴포넌트 등 UI 전 요소를 표준화하고 이를 Port Insight에도 적용하였습니다.

2. 조회 기간 설정 기능 추가

•
작업 완료 후 출발 선박 목록이 기존에는 3일로 고정되어 조회되었으나, 이제 사용자가 원하는 날짜를 직접 선택하여 조회할 수 있도록 개선되었습니다.

3. Congestion Index 신규 추가

•
기존에는 Port Insight가 제공하는 항구 중 선택된 항구의 순위만으로 혼잡도를 판단했지만, 신규 혼잡도 지수는 해당 항구의 과거 혼잡 데이터를 단계별로 산출하고, 이를 기반으로 현재 혼잡도를 수치화하여 제공합니다. 이를 통해 혼잡도 정보의 신뢰도가 크게 향상되었습니다.
•
Index Trend: 기존에는 실시간 혼잡도만 확인할 수 있었으나, 이제 혼잡도를 단계별로 수치화하여 기간별 추세로 조회할 수 있습니다.
•
Waiting & Working Trend: 혼잡도 지수가 생성된 시점의 Waiting 및 Working 수치를 함께 제공하여, 시간에 따른 변화 추세를 보다 명확하게 파악할 수 있도록 기능이 개선되었습니다.

4. 속도 개선

•
전반적인 속도를 개선하여 로딩 시간을 단축하였습니다.

변경 사항

1. API 엔드포인트 변경

•
Port Insight
◦
선박 데이터와 영역 데이터를 결합한 후, 이를 Port Insight API에 전달합니다.
API
SVMP
SeaVantage Insight
[GET] /port-insight
https://svmp.seavantage.com/api/v1/portInsight
https://insight.seavantage.com/api/port-insight
[GET] /port-insight/ships/history
https://svmp.seavantage.com/api/v1/portInsight
https://insight.seavantage.com/api/port-insight/ships/history
[GET] /port-insight/current
https://svmp.seavantage.com/api/v1/portInsight
https://insight.seavantage.com/api/port-insight/ships/current
•
Port Insight Next Calling
API
SVMP
SeaVantage Insight
[GET] /port-insight/next-calling/terminals
https://svmp.seavantage.com/api/v1/portInsight/statistic/nextCalling/pie
https://insight.seavantage.com/api/port-insight/next-calling/terminals
[GET] /port-insight/next-calling/ship-type-sizes
https://svmp.seavantage.com/api/v1/portInsightShipType/statistic/nextCalling/pie
https://insight.seavantage.com/api/port-insight/next-calling/ship-type-sizes
[GET] /port-insight/next-calling/monthly/terminals
https://svmp.seavantage.com/api/v1/portInsight/statistic/nextCalling/bar
https://insight.seavantage.com/api/port-insight/next-calling/monthly/terminals
[GET] /port-insight/next-calling/monthly/ship-type-sizes
https://svmp.seavantage.com/api/v1/portInsightShipType/statistic/nextCalling/bar
https://insight.seavantage.com/api/port-insight/next-calling/monthly/ship-type-sizes
•
Port Insight Previous Calling
API
SVMP
SeaVantage Insight
[GET] /port-insight/previous-calling/terminals
https://svmp.seavantage.com/api/v1/portInsight/statistic/lastCalling/pie
https://insight.seavantage.com/api/port-insight/previous-calling/terminals
[GET] /port-insight/previous-calling/ship-type-sizes
https://svmp.seavantage.com/api/v1/portInsightShipType/statistic/lastCalling/pie
https://insight.seavantage.com/api/port-insight/previous-calling/ship-type-sizes
[GET] /port-insight/previous-calling/monthly/terminals
https://svmp.seavantage.com/api/v1/portInsight/statistic/lastCalling/bar
https://insight.seavantage.com/api/port-insight/previous-calling/monthly/terminals
[GET] /port-insight/previous-calling/monthly/ship-type-sizes
https://svmp.seavantage.com/api/v1/portInsightShipType/statistic/lastCalling/bar
https://insight.seavantage.com/api/port-insight/previous-calling/monthly/ship-type-sizes
•
Port Insight Statistics
API
SVMP
SeaVantage Insight
[GET] /port-insight/statistics/terminals
https://svmp.seavantage.com/api/v1/portInsight/statistic
https://insight.seavantage.com/api/port-insight/statistics/terminals
[GET] /port-insight/statistics/ship-type-sizes
https://svmp.seavantage.com/api/v1/portInsightShipType/statistic
https://insight.seavantage.com/api/port-insight/statistics/ship-type-sizes
[GET] /port-insight/statistics/ports
https://svmp.seavantage.com/api/v1/portInsight/statistic
https://insight.seavantage.com/api/port-insight/statistics/ports
•
Port
API
SVMP
SeaVantage Insight
[GET] /port
https://svmp.seavantage.com/api/v1/port
https://insight.seavantage.com/api/port
[GET] /port/{portId}
https://svmp.seavantage.com/api/v1/port
https://insight.seavantage.com/api/port/{portId}
[GET] /port/terminal
https://svmp.seavantage.com/api/v1/port
https://insight.seavantage.com/api/port/terminal
[GET] /port/all
https://svmp.seavantage.com/api/v1/port
https://insight.seavantage.com/api/port/all

2. 스웨거 URL 변경

SVMP 데이터 이관

데이터 이관에는 당사 기준 약 30분 정도가 소요되며, 원활한 진행을 위해 고객사와 사전에 가능한 시간을 협의해 주시기 바랍니다. 일정 확정 및 세부 조율은 sales@seavantage.com로 연락해 주세요.