服务介绍

查询全球潮汐观测站每天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/GetGlobalTideData	Get

请求调用示例

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

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

⚪0成功

application/json

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

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "overview": [
            {
                "tide_date": "2025-03-05",
                "tide_time1": "00:10",
                "tide_time2": "06:33",
                "tide_time3": "12:43",
                "tide_time4": "19:12",
                "tide_height1": 3.8,
                "tide_height2": 0.1,
                "tide_height3": 4.2,
                "tide_height4": 0.6,
                "tide_lowhigh1": "高潮一",
                "tide_lowhigh2": "低潮二",
                "tide_lowhigh3": "高潮三",
                "tide_lowhigh4": "低潮四"
            },
            {
                "tide_date": "2025-03-04",
                "tide_time1": "05:55",
                "tide_time2": "11:56",
                "tide_time3": "18:22",
                "tide_time4": "     ",
                "tide_height1": 0,
                "tide_height2": 4.2,
                "tide_height3": 0.3,
                "tide_height4": 0,
                "tide_lowhigh1": "低潮一",
                "tide_lowhigh2": "高潮二",
                "tide_lowhigh3": "高潮三",
                "tide_lowhigh4": "高潮四"
            },
            {
                "tide_date": "2025-03-03",
                "tide_time1": "05:19",
                "tide_time2": "11:13",
                "tide_time3": "17:38",
                "tide_time4": "23:29",
                "tide_height1": 0,
                "tide_height2": 4.1,
                "tide_height3": 0.1,
                "tide_height4": 4.1,
                "tide_lowhigh1": "低潮一",
                "tide_lowhigh2": "高潮二",
                "tide_lowhigh3": "低潮三",
                "tide_lowhigh4": "高潮四"
            },
            {
                "tide_date": "2025-03-02",
                "tide_time1": "04:44",
                "tide_time2": "10:33",
                "tide_time3": "16:55",
                "tide_time4": "22:51",
                "tide_height1": 0.1,
                "tide_height2": 4,
                "tide_height3": 0,
                "tide_height4": 4.2,
                "tide_lowhigh1": "低潮一",
                "tide_lowhigh2": "高潮二",
                "tide_lowhigh3": "低潮三",
                "tide_lowhigh4": "高潮四"
            },
            {
                "tide_date": "2025-03-01",
                "tide_time1": "04:10",
                "tide_time2": "09:56",
                "tide_time3": "16:14",
                "tide_time4": "22:14",
                "tide_height1": 0.2,
                "tide_height2": 3.8,
                "tide_height3": 0,
                "tide_height4": 4.3,
                "tide_lowhigh1": "低潮一",
                "tide_lowhigh2": "高潮二",
                "tide_lowhigh3": "低潮三",
                "tide_lowhigh4": "高潮四"
            }
        ],
        "detail": [
            {
                "tide_date": "2025-03-05",
                "h0": 3.79,
                "h1": 3.64,
                "h2": 3.1,
                "h3": 2.31,
                "h4": 1.44,
                "h5": 0.65,
                "h6": 0.14,
                "h7": 0.11,
                "h8": 0.64,
                "h9": 1.57,
                "h10": 2.62,
                "h11": 3.52,
                "h12": 4.07,
                "h13": 4.17,
                "h14": 3.86,
                "h15": 3.22,
                "h16": 2.4,
                "h17": 1.59,
                "h18": 0.92,
                "h19": 0.6,
                "h20": 0.75,
                "h21": 1.3,
                "h22": 2.04,
                "h23": 2.77
            },
            {
                "tide_date": "2025-03-04",
                "h0": 3.99,
                "h1": 3.53,
                "h2": 2.74,
                "h3": 1.81,
                "h4": 0.91,
                "h5": 0.22,
                "h6": -0.03,
                "h7": 0.33,
                "h8": 1.2,
                "h9": 2.29,
                "h10": 3.29,
                "h11": 3.98,
                "h12": 4.2,
                "h13": 3.95,
                "h14": 3.32,
                "h15": 2.45,
                "h16": 1.56,
                "h17": 0.78,
                "h18": 0.33,
                "h19": 0.41,
                "h20": 1,
                "h21": 1.87,
                "h22": 2.78,
                "h23": 3.47
            },
            {
                "tide_date": "2025-03-03",
                "h0": 3.9,
                "h1": 3.2,
                "h2": 2.28,
                "h3": 1.32,
                "h4": 0.49,
                "h5": 0.02,
                "h6": 0.14,
                "h7": 0.84,
                "h8": 1.87,
                "h9": 2.93,
                "h10": 3.73,
                "h11": 4.1,
                "h12": 3.97,
                "h13": 3.41,
                "h14": 2.56,
                "h15": 1.64,
                "h16": 0.79,
                "h17": 0.21,
                "h18": 0.14,
                "h19": 0.67,
                "h20": 1.59,
                "h21": 2.63,
                "h22": 3.5,
                "h23": 3.99
            },
            {
                "tide_date": "2025-03-02",
                "h0": 3.62,
                "h1": 2.76,
                "h2": 1.8,
                "h3": 0.9,
                "h4": 0.26,
                "h5": 0.11,
                "h6": 0.57,
                "h7": 1.46,
                "h8": 2.48,
                "h9": 3.35,
                "h10": 3.87,
                "h11": 3.9,
                "h12": 3.48,
                "h13": 2.71,
                "h14": 1.8,
                "h15": 0.93,
                "h16": 0.25,
                "h17": 0.01,
                "h18": 0.38,
                "h19": 1.25,
                "h20": 2.35,
                "h21": 3.36,
                "h22": 4.04,
                "h23": 4.22
            },
            {
                "tide_date": "2025-03-01",
                "h0": 3.2,
                "h1": 2.29,
                "h2": 1.38,
                "h3": 0.62,
                "h4": 0.25,
                "h5": 0.44,
                "h6": 1.11,
                "h7": 2.02,
                "h8": 2.9,
                "h9": 3.54,
                "h10": 3.75,
                "h11": 3.49,
                "h12": 2.85,
                "h13": 2.01,
                "h14": 1.15,
                "h15": 0.42,
                "h16": 0.04,
                "h17": 0.21,
                "h18": 0.94,
                "h19": 2,
                "h20": 3.1,
                "h21": 3.92,
                "h22": 4.31,
                "h23": 4.18
            }
        ]
    }
}

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

服务介绍

适用场景

1、船舶航行安全

2、港口运营与管理

3、救援应急

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

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

服务介绍#

适用场景#

1、船舶航行安全#

2、港口运营与管理#

3、救援应急#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

1、船舶航行安全

2、港口运营与管理

3、救援应急

请求限制

在线调试

请求地址

请求调用示例