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	天気、海洋、天文情報を1回のリクエストで取得
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"

レート制限

プラン	リクエスト数	価格
無料	1回限りのクレジット50回分	$0
Hobby	1日あたり500回	$4.99/mo
Starter	1日あたり1,000回	$9/mo
Pro	1日あたり10,000回	$29/mo
Business	1日あたり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 自体は商用サービスです。利用規約をご覧ください。