逐小时潮汐

获取指定港口或者某个城市下的全部港口未来最多 18 天的潮汐数据,包括每天 24 小时的逐小时潮汐高度,以及每天的高低潮时间及高度。

支持的城市与港口列表在此下载。注意 port ID 和 location ID 是不同的两套 ID,不是混用等价的关系。用 port 参数只会返回对应的港口数据,用 location 参数会返回该城市下所有的港口的数据。

更新频率查看

请求地址示例

参数

参数名 类型 默认值 必须 备注
key String 你的 API 密钥
location Location 所查询的位置
port Port 所查询的港口(与 location 参数二选一)

返回结果

{
  "results": [
    {
      "location": {
        "id": "WZ0KQ36Y0N4N",
        "name": "丹东",
        "country": "CN",
        "path": "丹东,辽宁",
        "timezone": "Asia/Shanghai"
      },
      "ports": [
        {
          "port": {
            "id": "WXPFPURBXCPF",
            "name": "大鹿岛",
            "path": "大鹿岛,辽宁",
            "latitude": "39.75",         //纬度
            "longitude": "123.75",       //经度
            "sea_level": "332"           //平均海平面
          },
          "data": [
            {
              "date": "2018-03-27",
              "tide": [                  // 单位:cm
                "227.71",                // 北京时间0时潮汐高度
                "277.79",                // 北京时间1时潮汐高度
                "335.29",
                "383.39",
                "410.92",
                "413.37",
                "391.11",
                "347.85",
                "291.16",
                "233.68",
                "191.84",
                "180.79",
                "207.63",
                "267.53",
                "345.43",
                "422.32",
                "481.82",
                "513.57",
                "512.91",
                "479.60",
                "418.18",
                "339.57",
                "261.24",
                "203.24"                 // 北京时间23时潮汐高度
              ],
              "range": [                 // 高(低)潮时间及高度
                {
                  "time": "2018-03-27T04:36:00+08:00",
                  "height": "415.45",    // 单位:cm
                  "type": "high"         // 类型( "high" | "low" )
                },
                ....
              ]
            },
            ....
          ]
        },
        {
          "port": {
            "id": "WXPGQ4MXZGGS",
            "name": "石山子",
            "path": "石山子,辽宁",
            "latitude": "39.96",
            "longitude": "123.67",
            "sea_level": "200"
          },
          "data": []
        },
        {
          "port": {
            "id": "WZ0KQC3Q4N5N",
            "name": "丹东",
            "path": "丹东,辽宁",
            "latitude": "40.13",
            "longitude": "124.40",
            "sea_level": "150"
          },
          "data": []
        }
      ],
      "last_update": "2018-03-27T07:28:00+08:00"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88