Global Vessels

Access global vessel data including ship details, movements, port calls, and fleet insights using MMSI-based queries and advanced filters.

原始信息汇总

Global Vessels API 数据集概述

基本信息

• 数据集名称: Global Vessels
• 提供者: International Centre for Trade Transparency Limited
• 类别: Logistics
• API版本: 0.1.0 (current)
• 基础URL: https://{your-rapidapi-host}
• 端点前缀: /trade-service/marketplace/v1
• 认证方式: API Key (请求头 X-API-Key: YOUR_API_KEY)

性能指标

• 流行度: 9.2
• 服务等级: 100%
• 延迟: 3134ms

订阅计划

• BASIC: $0.00 / 月
• PRO: $260.00 / 月
• ULTRA: $2,600.00 / 月

核心功能

船舶发现与搜索

• 分页船舶列表
• 按船舶类型、国家、船东、运营商、TEU范围筛选
• 跨船舶元数据的关键词搜索

船队与摘要洞察

• 总船舶数与活跃船舶数对比
• 聚合船舶统计数据
• 高级船队情报

港口停靠与海事历史

• 指定日期范围内的港口停靠历史
• 每艘船舶的完整历史港口停靠记录
• 特定港口的船舶活动

船舶移动与航线

• 基于时间的船舶移动跟踪
• 用于地图可视化的航线重建
• AIS驱动的船舶活动数据

主要端点

船舶端点

• GET /vessels: 列出和筛选船舶
• GET /vessels/{mmsi}: 获取船舶详细信息
• GET /vessels/summary: 获取船队摘要统计

港口停靠端点

• GET /vessels/portcalls: 获取日期范围内的港口停靠记录
• GET /vessels/ship-portcalls: 获取完整的船舶港口停靠历史

船舶移动端点

• GET /vessels/ship-movement: 获取船舶移动和航线数据

示例请求与响应

• 示例请求: GET /trade-service/marketplace/v1/vessels?offset=0&limit=10&ship_type=container
• 示例响应格式: json { "status_code": 200, "data": { "items": [], "total": 0, "page": 1, "page_size": 10 } }

错误处理

验证错误遵循一致格式: json { "detail": [ { "loc": ["query", "mmsi"], "msg": "field required", "type": "value_error.missing" } ] }

最佳应用场景

• 船舶跟踪平台
• 海事地图可视化
• 船队管理与分析
• 基于AIS的移动仪表板
• 航运与物流情报

开发者建议

• 始终对船舶列表进行分页（使用 offset, limit 参数）
• 使用日期过滤器（from_date, to_date）进行高效查询
• 结合船舶移动和港口停靠数据以获得更丰富的洞察
• 适用于实时仪表板和商业智能工具