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로 연락해 주세요.