Global Ports

Global seaport data: port details, container traffic, freight rates, trade flows, vessel tracking, and shipping analytics by UN/LOCODE.

原始信息汇总

Global Ports API 数据集概述

数据集基本信息

• 数据集名称: Global Ports
• 类别: Logistics
• 提供者: International Centre for Trade Transparency Limited
• API版本: 1.0.0 (current)
• 基础URL: /trade-service/marketplace/v1
• 订阅计划:
  • BASIC: $0.00 / mo
  • PRO: $260.00 / mo
  • ULTRA: $2,600.00 / mo
• 性能指标:
  • 流行度: 9.3
  • 服务等级: 100%
  • 延迟: 2331ms
  • 测试: N/A

数据集描述

全球海港数据：包括港口详情、集装箱流量、运费费率、贸易流、船舶跟踪以及基于UN/LOCODE的航运分析。

主要功能与用途

• 搜索和筛选全球港口。
• 分析港口绩效和周转时间。
• 跟踪港口呼叫和船舶活动。
• 探索集装箱容量和码头数据。
• 监控贸易流、交货时间和运费指数。
• 在地理地图区域可视化船舶。
• 适用场景:
  • 物流与供应链平台
  • 贸易分析工具
  • 海事情报仪表板
  • 研究与市场分析

可用端点

港口发现

• Get Ports (Search & Filter): GET /ports
  • 可选查询参数: country_code, region, keyword, offset (默认: 0), limit (默认: 10)
• Get Port Dropdown List: GET /ports/dropdown
  • 必需参数: page, page_size
  • 可选参数: s (搜索关键词)
• Get Port Details: GET /ports/{port_id}

港口绩效与运营

• Turnaround Time: GET /ports/turnaround
• Port Waiting Times: GET /ports/port-waiting-times
• Port Call Timeliness: GET /ports/portcall-timeliness
• 以上端点均需要 locode 作为查询参数。

集装箱与码头

• Container Type Table: GET /ports/container-type-table
• Containers in Terminal: GET /ports/containers-in-terminal

贸易与分析

• Trade by Partner Series: GET /ports/trade-by-partner-series
• Country-to-Country Trade: GET /ports/country-to-country-trade
• Sea Trade by Week: GET /ports/sea-trade-by-week
• Lead Times: GET /ports/lead-times-new

运费与市场指标

• Freight Rate Index: GET /ports/freight-rate-index

船舶与地图

• Search Port Calls: GET /ports/portcalls
• Ships in Map View: GET /ports/ships-in-map
  • 定义边界框和中心点以检索地图区域内的船舶。

错误处理

• API使用标准HTTP响应代码。
  • 200 – 成功
  • 422 – 验证错误（参数无效或缺失）
• 错误响应结构示例: json { "detail": [ { "loc": ["query", "locode"], "msg": "field required", "type": "value_error.missing" } ] }