Tide

Platform: API iOS Android

Global tidal data for the next 10 days, including tide table and hourly tide forecast data.

Endpoint

/v7/ocean/tide

Parameters

Query parameters

location(required)The tide station to be queried, need LocationID and LocationID can be obtained by POI Lookup. For example: location=P2951
date(required)Set the date, up to 10 days in the future (including today). The date format is yyyyMMdd. Eexample: date=20200531

Request example

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/v7/ocean/tide?location=P2951&date=20210206'

Replace your_token and your_api_host with your JWT Authentication and API Host

Response

The response is in JSON format and is Gzip compressed.

{
  "code": "200",
  "updateTime": "2021-02-04T05:02+08:00",
  "fxLink": "https://www.qweather.com",
  "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": [
      "QWeather Developers License"
    ]
  }
}

code See Status Code
updateTime API last update time
fxLink Responsive web page of this data, for embedded in website or APP
tideTable.fxTime High tide or Low tide time
tideTable.height The height of the wave, in meters
tideTable.type High tide (H) or Low tide (L)
tideHourly.fxTime Hourly forecast time
tideHourly.height The height of the wave, in meters, maybe null for some POI
refer.sources Data source and other statements, may be null
refer.license Data license, may be null