?

請(qǐng)求URL

https://data.sailxy.com/Gettide?[請(qǐng)求參數(shù)]

請(qǐng)求參數(shù)

請(qǐng)求參數(shù)包括必選和可選參數(shù)，如不填寫可選參數(shù)將使用其默認(rèn)值，參數(shù)之間使用&進(jìn)行分隔。

location

需要查詢的潮汐站點(diǎn)，請(qǐng)?zhí)顚懗毕军c(diǎn)的LocationID，LocationID可通過潮汐站點(diǎn)列表獲取

date

選擇日期，最多可選擇未來10天（包含今天）的數(shù)據(jù)。日期格式為yyyyMMdd，例如date=20200531

uid

用戶id，獲取uid請(qǐng)聯(lián)系作者。例如uid=hy2021726

timestamp

當(dāng)前時(shí)間戳，例如 timestamp=1627283926，注意必須是當(dāng)前時(shí)間，時(shí)間戳五分鐘內(nèi)有效

key

用戶秘鑰，使用uid對(duì)應(yīng)的秘鑰ukey+timestamp取md5值，例如uid=hy2021726對(duì)應(yīng)的秘鑰為abcdef，key參數(shù)值就是對(duì)adcdef1627283926取MD5

返回?cái)?shù)據(jù)

{
  "code": "200",
  "updateTime": "2021-02-04T05:02+08:00",
  "fxLink": "http://hfx.link/1",
  "tideTable": [
    {
      "fxTime": "2021-02-06T03:48+08:00",
      "height": "2.17",
      "type": "H"
    },
    {
      "fxTime": "2021-02-06T10:12+08:00",
      "height": "0.21",
      "type": "L"
    },
    {
      "fxTime": "2021-02-06T16:53+08:00",
      "height": "2.47",
      "type": "H"
    },
    {
      "fxTime": "2021-02-06T23:22+08:00",
      "height": "0.73",
      "type": "L"
    }
  ],
  "tideHourly": [
    {
      "fxTime": "2021-02-06T00:00+08:00",
      "height": "1.02"
    },
    {
      "fxTime": "2021-02-06T01:00+08:00",
      "height": "1.42"
    },
    {
      "fxTime": "2021-02-06T02:00+08:00",
      "height": "1.82"
    },
    {
      "fxTime": "2021-02-06T03:00+08:00",
      "height": "2.10"
    },
    {
      "fxTime": "2021-02-06T04:00+08:00",
      "height": "2.16"
    },
    {
      "fxTime": "2021-02-06T05:00+08:00",
      "height": "2.01"
    },
    {
      "fxTime": "2021-02-06T06:00+08:00",
      "height": "1.68"
    },
    {
      "fxTime": "2021-02-06T07:00+08:00",
      "height": "1.23"
    },
    {
      "fxTime": "2021-02-06T08:00+08:00",
      "height": "0.77"
    },
    {
      "fxTime": "2021-02-06T09:00+08:00",
      "height": "0.39"
    },
    {
      "fxTime": "2021-02-06T10:00+08:00",
      "height": "0.21"
    },
    {
      "fxTime": "2021-02-06T11:00+08:00",
      "height": "0.29"
    },
    {
      "fxTime": "2021-02-06T12:00+08:00",
      "height": "0.60"
    },
    {
      "fxTime": "2021-02-06T13:00+08:00",
      "height": "1.07"
    },
    {
      "fxTime": "2021-02-06T14:00+08:00",
      "height": "1.60"
    },
    {
      "fxTime": "2021-02-06T15:00+08:00",
      "height": "2.07"
    },
    {
      "fxTime": "2021-02-06T16:00+08:00",
      "height": "2.38"
    },
    {
      "fxTime": "2021-02-06T17:00+08:00",
      "height": "2.47"
    },
    {
      "fxTime": "2021-02-06T18:00+08:00",
      "height": "2.34"
    },
    {
      "fxTime": "2021-02-06T19:00+08:00",
      "height": "2.05"
    },
    {
      "fxTime": "2021-02-06T20:00+08:00",
      "height": "1.66"
    },
    {
      "fxTime": "2021-02-06T21:00+08:00",
      "height": "1.25"
    },
    {
      "fxTime": "2021-02-06T22:00+08:00",
      "height": "0.91"
    },
    {
      "fxTime": "2021-02-06T23:00+08:00",
      "height": "0.74"
    }
  ],
  "refer": {
    "sources": [
      "qweather.com"
    ],
    "license": [
      "commercial license"
    ]
  }
}

參數(shù)	描述
code	API狀態(tài)碼，具體含義請(qǐng)參考狀態(tài)碼
updateTime	當(dāng)前API的最近更新時(shí)間
fxLink	當(dāng)前數(shù)據(jù)的響應(yīng)式頁面，便于嵌入網(wǎng)站或應(yīng)用
tideTable.fxTime	滿潮或干潮時(shí)間
tideTable.height	海水高度，單位：米
tideTable.type	滿潮（H）或干潮（L）
tideHourly.fxTime	逐小時(shí)預(yù)報(bào)時(shí)間
tideHourly.height	海水高度，單位：米
refer.sources	原始數(shù)據(jù)來源，或數(shù)據(jù)源說明，可能為空
refer.license	數(shù)據(jù)許可或版權(quán)聲明，可能為空

狀態(tài)碼

通過API接口中的code字段，可以獲取到當(dāng)前請(qǐng)求的狀態(tài)，判斷請(qǐng)求是否成功或出現(xiàn)錯(cuò)誤。

代碼	說明
200	請(qǐng)求成功
204	請(qǐng)求成功，但你查詢的地區(qū)暫時(shí)沒有你需要的數(shù)據(jù)。
400	請(qǐng)求錯(cuò)誤，可能包含錯(cuò)誤的請(qǐng)求參數(shù)或缺少必選的請(qǐng)求參數(shù)。
401	認(rèn)證失敗，可能使用了錯(cuò)誤的KEY、數(shù)字簽名錯(cuò)誤、KEY的類型錯(cuò)誤（如使用SDK的KEY去訪問Web API）。
402	超過訪問次數(shù)或余額不足以支持繼續(xù)訪問服務(wù)，你可以充值、升級(jí)訪問量或等待訪問量重置。
403	無訪問權(quán)限，可能是綁定的PackageName、BundleID、域名IP地址不一致，或者是需要額外付費(fèi)的數(shù)據(jù)。
404	查詢的數(shù)據(jù)或地區(qū)不存在。
429	超過限定的QPM（每分鐘訪問次數(shù)），請(qǐng)參考QPM說明
500	無響應(yīng)或超時(shí)，接口服務(wù)異常請(qǐng)聯(lián)系我們

演示地址 ：電子海圖，潮汐查詢

?

添加微信聯(lián)系作者：lvxin6136

總結(jié)

以上是生活随笔為你收集整理的全球潮汐数据API使用方法，潮汐数据查询的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。