TidesAtlas

TidesAtlas API

为 180 个国家的 13,000 多个港口提供全球潮汐预测、海洋预报和天文数据。

基础 URL： https://tidesatlas.com/api/v1

文档： tidesatlas.com/api/docs

控制面板： tidesatlas.com/api/dashboard

---

功能

• 潮汐预测：覆盖 180 个国家的 13,000 多个港口
• 潮汐系数（法国系数刻度，20-120）
• 天气预报 — 温度、风、降水、UV 指数
• 海洋数据 — 浪高、涌浪、浪向、海况
• 天文数据 — 日出、日落、月相、照明度
• 多种基准面 — LAT、MSL、MLLW、MHW、MHHW 等
• 实时观测数据：法国 REFMAR 站点

快速开始

1. 在 tidesatlas.com/api/register 注册（赠送 50 个免费额度，无需信用卡）
2. 从控制面板复制 API 密钥
3. 发起首次调用：

curl -H "X-API-Key: YOUR_KEY" \
  "https://tidesatlas.com/api/v1/tides?port=brest&days=3"

端点

端点	描述
GET /tides	高潮和低潮时间、水位及系数
GET /ports	按名称、坐标或国家搜索港口
GET /countries	列出所有国家及其港口数量
GET /weather	天气预报（1-7 天）
GET /marine	波浪和涌浪预报（1-7 天）
GET /astronomy	日出、日落、月相
GET /conditions	一次调用获取天气、海洋和天文数据
GET /history	历史潮汐和天气数据

身份验证

在 X-API-Key 标头中传入 API 密钥：

X-API-Key: ta_your_api_key_here

示例

多种语言的完整可运行示例：

• Python
• JavaScript / Node.js
• PHP
• cURL

响应示例

{
  "port": {
    "name": "Brest",
    "slug": "brest",
    "country": "France",
    "region": "Brittany"
  },
  "datum": {
    "reference": "LAT",
    "available": ["LAT", "MSL", "MLLW", "MHW", "MLW", "MHHW", "MTL"]
  },
  "extremes": [
    {
      "datetime": "2026-05-13T05:18:00+02:00",
      "height_m": 6.79,
      "type": "high"
    },
    {
      "datetime": "2026-05-13T11:45:00+02:00",
      "height_m": 0.82,
      "type": "low"
    }
  ]
}

基准面转换

以任何受支持的参考系请求高度：

# Heights relative to Mean Sea Level
curl -H "X-API-Key: KEY" \
  "https://tidesatlas.com/api/v1/tides?port=brest&datum=MSL"

# Heights relative to Mean Lower Low Water (US standard)
curl -H "X-API-Key: KEY" \
  "https://tidesatlas.com/api/v1/tides?port=seattle&datum=MLLW"

速率限制

套餐	请求数	价格
Free	一次性 50 个额度	$0
Hobby	每天 500 次	$4.99/mo
Starter	每天 1,000 次	$9/mo
Pro	每天 10,000 次	$29/mo
Business	每天 50,000 次	$79/mo

每个响应都包含速率限制标头：

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 347
X-RateLimit-Reset: 1715644800

数据来源

• 潮汐预测： 使用 TICON-4 和 FES2022 潮汐分量进行谐波分析
• 天气： 通过 Open-Meteo 获取 NOAA GFS 数据（CC BY 4.0）
• 海洋： 通过 Open-Meteo 获取 Copernicus Marine / ECMWF 数据（CC BY 4.0）
• 天文数据： 根据日月星历计算

状态

API 状态页面：tidesatlas.com/api/status

支持

• 电子邮件：[email protected]
• 问题反馈：GitHub Issues

许可证

此代码库仅包含文档和示例代码。示例代码以 MIT License 发布。API 本身是一项商业服务，详情请参阅使用条款。