船舶定位与航程跟踪 API

API ID 4071

船舶定位和航行跟踪API使用户能够通过使用船舶的IMO号码访问关于任何船只的详细实时位置信息和航向

100% 正常运行时间 1,499 ms 平均响应

API 文档

端点

请求

提供船舶的IMO号码并检索有关船只的信息

获取数据如下:

  • IMO号码
  • 船舶名称
  • 船舶类型
  • 国旗
  • 总吨位
  • 夏季载重吨(吨)
  • 总长(米)
  • 宽度(米)
  • 建造年份
Endpoint ID: 4901
GET https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/4901/vessel+information
输入参数

船舶信息 — 端点功能

对象 描述
imoCode 必需 The Vessel's IMO code.

剩余免费测试请求:3 / 3。


输入参数

imoCode
API 示例响应
JSON
{"status":200,"success":true,"message":"IMO Code 9270622 is valid","data":{"imo_number":"9270622","vessel_name":"AQUAMAN","ship_type":"Offshore Tug\/Supply Ship","flag":"Vanuatu","gross_tonnage":"2332","summer_deadweight_t":"2162","length_overall_m":"69","beam_m":"16","year_of_built":"2003"}}
船舶信息 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/4901/vessel+information?imoCode=9702510' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求

此端点将允许您检索所需船舶的当前航线 

获取:

  • 出发港口
  • 出发时间ATD
  • 呼号
  • 国旗
  • 长度 / 宽度
  • IMO / MMSI
  • 航行状态
  • 当前吃水
  • 航向 / 速度
  • 到达港口
  • 到达时间ETA

此外,检索最新的港口,以及它们在该港口停留的时间 

Endpoint ID: 4902
GET https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/4902/get+route
输入参数

获取路线 — 端点功能

对象 描述
imoCode 必需 The Vessel's IMO code.

剩余免费测试请求:3 / 3。


输入参数

imoCode
API 示例响应
JSON
{"status":200,"success":true,"message":"IMO Code 9251183 is valid","data":{"departure_port":"Saint George, Bermuda","departure_atd":"ATD: May 13, 21:21 UTC (44 days ago)","callsign":"V7A4876","flag":"Marshall Islands","length_beam":"119 \/ 19 m","imo_mmsi":"9251183 \/ 538009548","navigation_status":"-","current_draught":"5.1 m","course_speed":"\u00a0","arrival_port":"FOR ORDERS","arrival_atd":"ETA: Jun 30, 00:00","latest_port_calls":[{"port_name":"Saint George, Bermuda","arrival_utc":"2024-05-13T10:41:00.000000Z","departure_utc":"2024-05-13T21:21:00.000000Z","time_in_port":"10 hours, 40 minutes"},{"port_name":"locked, ","arrival_utc":"2024-05-03T14:33:00.000000Z","departure_utc":"2024-05-04T14:16:00.000000Z","time_in_port":"23 hours, 43 minutes"}]}}
获取路线 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/4902/get+route?imoCode=9251183' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求

传递船舶MMSI代码并获取船舶信息

获取数据例如:

  • 接收位置
  • 区域
  • 当前港口
  • 坐标
  • 导航状态
  • 上一个港口调用
  • 到达
  • 离开
  • 在港时间
Endpoint ID: 6117
GET https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/6117/get+latest+ports+by+mmsi+code
输入参数

通过MMSI代码获取最新港口 — 端点功能

对象 描述
mmsiCode 必需 Indicates an MMSI Code

剩余免费测试请求:3 / 3。


输入参数

mmsiCode
API 示例响应
JSON
{"status":200,"success":true,"message":"MMSI Code 205566190 is valid","data":{"position_received":"15 m ago","vessel_local_time":"-","area":"North Sea","current_port":"PUURS ZEEKANAAL BRUS","latitude_longitude":"51.11120\u00b0 \/ 4.29875\u00b0","navigational_status":"Moored","speed_course":"","ais_source":"-","last_port_calls":[{"port":"ANTWERP","arrival":"2024-08-04 10:23","departure":"2024-08-04 14:09","time_in_port":"3 h"},{"port":"THOLEN","arrival":"2024-08-03 11:21","departure":"2024-08-04 08:48","time_in_port":"21 h"},{"port":"BOTLEK - ROTTERDAM","arrival":"2024-07-30 15:45","departure":"2024-08-01 11:46","time_in_port":"1 d"},{"port":"AMSTERDAM","arrival":"2024-07-27 15:52","departure":"2024-07-30 06:58","time_in_port":"2 d"},{"port":"NIEUWEGEIN","arrival":"2024-07-27 09:38","departure":"2024-07-27 11:06","time_in_port":"1 h"},{"port":"HANSWEERT","arrival":"2024-07-26 14:28","departure":"2024-07-26 14:42","time_in_port":"13 m"},{"port":"SLUISKIL","arrival":"2024-07-25 20:38","departure":"2024-07-26 10:41","time_in_port":"14 h"},{"port":"ANTWERP","arrival":"2024-07-25 14:09","departure":"2024-07-25 16:38","time_in_port":"2 h"},{"port":"THOLEN","arrival":"2024-07-19 15:32","departure":"2024-07-25 10:56","time_in_port":"5 d"},{"port":"KEIZERSVEER","arrival":"2024-07-19 09:42","departure":"2024-07-19 10:17","time_in_port":"35 m"}]}}
通过MMSI代码获取最新港口 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/4071/ship+positioning+and+voyage+tracking+api/6117/get+latest+ports+by+mmsi+code?mmsiCode=258785000' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 船舶定位与航程跟踪 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

关于API: 

该API为主要海港提供先进的船只跟踪和管理系统,实时提供船只状态和动向的数据。它提供有关船只位置、航行状态、当前港口、到达和离开的港口以及港口特定的天气条件(包括温度、风速和湿度)的详细信息。

通过利用IMO(国际海事组织编号)和MMSI(海事移动服务标识)等唯一标识符,该API实现了精确的船只跟踪,提供关于最近港口停靠、停留时间和计划动向的全面视图。这些数据对于优化港口运营、简化物流和提高航行安全至关重要。

该API使用AIS数据提供船只的实时位置,包括纬度、经度、航向、速度、航行状态、目的地和预计到达时间。信息来自陆地或卫星来源,以提供全球覆盖和海上跟踪的准确性。

此外,API还包括特定港口预计到达船只的信息,提供预计到达时间和关键船只详细信息,包括注册国家和MMSI编号。它还提供港口的实时天气更新,以支持高效的运营规划和海上安全。

船舶定位与航程跟踪 API FAQs

船舶定位与航程跟踪API是一项服务,允许开发者实时访问船舶信息并使用唯一的国际海事组织(IMO)号码跟踪船舶的航线。它提供有关船舶位置、速度、航向、目的地等的综合数据

该API提供丰富的船舶数据,如航向、目的地、预计到达时间(ETA)以及有关其航线的历史信息。这些信息允许实时跟踪船舶及分析它们的过去运动

船舶定位和航程跟踪API努力提供准确和最新的船舶跟踪数据但是请注意船舶位置和其他数据受到多种因素的影响例如船舶报告频率接收质量和数据源可靠性

API本身并不提供原生的警报或通知功能。然而开发者可以利用从API获取的数据在其应用程序中实现自定义警报系统根据特定的船只标准或事件触发通知

集成很简单 该API提供了良好的文档化端点并为开发者提供了清晰的请求和检索船舶信息的说明 详细的文档和代码示例使得集成变得容易

每个端点返回特定的船舶相关数据。例如 "GET Vessel Information" 端点提供 IMO 编号 船舶名称 和总吨位等详细信息 而 "GET Current Position" 端点提供实时位置信息 包括经度 纬度 和航行状态

关键字段因端点而异。在“获取船舶信息”中,重要字段包括“船舶名称”和“净吨位”。在“获取当前位置”中,关键字段包括“纬度”、“经度”和“航行状态”,这些提供了基本的跟踪信息

响应数据采用JSON格式结构,包含“状态”、“成功”、“消息”和一个“数据”对象。“数据”对象包含特定的船只信息,如位置、航线或船只详细信息,便于在应用程序中解析和使用

每个端点需要特定的参数。例如“获取船舶信息”需要一个IMO号码,而“获取航线”则需要船舶的IMO或MMSI。用户可以通过提供这些标识符来定制请求以获取目标数据

该API从AIS(自动识别系统)信号中获取数据,这些信号可以是陆基或基于卫星的。这种双重来源的方法增强了覆盖范围和准确性,使得能够在各个区域可靠地跟踪船只

典型的用例包括海运物流优化 实时船舶跟踪以确保安全以及港口的运营规划 企业可以分析船舶动向以根据准确的到达和离港数据改善调度和资源分配

用户可以利用返回的数据创建仪表板以监测船只动态 生成港口停靠报告或开发特定导航状态的警报系统 结构化的JSON格式便于与各种应用程序的集成

数据准确性通过AIS信号的定期更新和对接收数据的质量检查得以维护 API旨在提供实时信息 但用户应考虑信号接收和报告频率等可能影响准确性的因素

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API


您可能还喜欢