服务介绍

查询国内潮汐观测站每天24小时潮汐变化数据。其中潮汐高度是根据每个港口的潮汐基准面计算的高度数据，不同港口的潮汐基准面不同，需要在请求并计算数据时注意。注：港口潮汐观测站和船讯网中的港口并不是一个概念，查询时候应该使用观测站的port_code，而不是港口五位编码。

适用场景

1、船舶航行安全

船舶安全航行：潮汐数据对于船舶在狭窄水道、浅滩等复杂水域的航行安全至关重要。船长可以根据潮汐数据了解水深变化，提前做好应对措施，避免触礁、搁浅等事故的发生。

2、港口运营与管理

港口设施建设与维护：港口的码头、航道、防波堤等设施的建设和维护也需要参考潮汐数据。例如，在设计码头高度和航道深度时，要考虑到最高潮和最低潮时的水深情况，以确保船舶在不同潮位下都能正常靠泊和航行。

船舶进出港调度：港口的水深会随着潮汐的变化而改变，一些吃水较深的船舶只能在高潮时进出港。通过潮汐数据，港口调度部门可以合理安排船舶的进出港时间，避免船舶因水深不足而搁浅，提高港口的运营效率。

3、救援应急

应急处置与安全保障：在遇到突发事件，如船舶搁浅、碰撞等事故时，潮汐数据可以帮助救援应急部门快速评估事故现场的水文情况，制定合理的救援方案。

请求限制

此服务为高级服务，需要申请高级权限才可使用，使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。开通服务权限请联系商务。

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见 https://33iwh234s7.apifox.cn/8961339m0

请求地址

**注：**港口潮汐服务需要先请求国内港口潮汐观测站基本信息列表，再根据实际业务情况使用单个港口观测站的id查询港口潮汐详细数据。

接口名称	请求地址	请求方式
查询单个观测站潮汐详情	https://api.shipxy.com/apicall/v3/GetTideData	Get

请求调用示例

https://api.shipxy.com/apicall/v3/GetTideData?key=1F6D701272402D1E7D8D316CCE519123&port_code=8000005&start_date=2025-03-01&end_date=2025-03-05

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

返回响应

⚪0成功

application/json

成功返回单个观测站潮汐详情

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "string",
    "overview": [
        {
            "tide_date": "string",
            "tide_time1": "string",
            "tide_time2": "string",
            "tide_time3": "string",
            "tide_time4": "string",
            "tide_height1": 0,
            "tide_height2": 0,
            "tide_height3": 0,
            "tide_height4": 0,
            "tide_lowhigh1": "string",
            "tide_lowhigh2": "string",
            "tide_lowhigh3": "string",
            "tide_lowhigh4": "string"
        }
    ],
    "detail": [
        {
            "tide_date": "string",
            "h0": 0,
            "h1": 0,
            "h2": 0,
            "h3": 0,
            "h4": 0,
            "h5": 0,
            "h6": 0,
            "h7": 0,
            "h8": 0,
            "h9": 0,
            "h10": 0,
            "h11": 0,
            "h12": 0,
            "h13": 0,
            "h14": 0,
            "h15": 0,
            "h16": 0,
            "h17": 0,
            "h18": 0,
            "h19": 0,
            "h20": 0,
            "h21": 0,
            "h22": 0,
            "h23": 0
        }
    ]
}

6.3.2 查询单个观测站潮汐详情

服务介绍

适用场景

1、船舶航行安全

2、港口运营与管理

3、救援应急

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

6.3.2 查询单个观测站潮汐详情

服务介绍#

适用场景#

1、船舶航行安全#

2、港口运营与管理#

3、救援应急#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

1、船舶航行安全

2、港口运营与管理

3、救援应急

请求限制

在线调试

请求地址

请求调用示例