ktailab潮位API

開発のねらい

海上保安庁海洋情報部では、全国85箇所の験潮所にてリアルタイムに潮位データを収集しています。その情報は こちら でみることができます。これを利用させていただきました。 まず、指定した場所に最も近い験潮所を選択します。次に、そこから昨日の観測データを取得します。 当日の満潮、干潮時刻は前日から50分遅れになると予測します。緯度経度から潮位を計算するタイドグラフの計算式があるのですが、 日本国内に関しては、この方が精度よく推定できるのはないかと思ってます。

API仕様

URI : http://api.ktailab.net/weather/kaiho_tide.php?lat=$lat&lon=$lon&apikey=000000000000000000

入力パラメータ :

  • lat=dd.ddddd(実数) - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。)
  • lon=ddd.ddddd(実数) - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。)
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。

出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • lat - 入力された緯度です。
    • lon - 入力された経度です。
    • port - 選択されたの験潮所の名前です。
    • port_lat - 験潮所の緯度です。
    • port_lon - 験潮所の経度です。
    • req - 潮位データを取得した海上保安庁のURLです。
    • high_tide - 予測した満潮時刻(当日)です。
    • high_tide2 - 2度目の満潮時刻がある場合は表示されます。
    • high_level - 満潮レベルです。単位はcm。
    • low_tide - 予測した干潮時刻(当日)です。
    • low_tide2 - 2度目の干潮時刻がある場合は表示されます。
    • low_level - 干潮レベルです。単位はcm。
    • h00 - h23 - 前日の潮位レベルです。単位はcm。

例

  • 東京
  • 横浜
  • 利尻島
  • 石垣島

変更履歴

  • ver 1.0.0 : ベータ版公開 2008/08/13
  • ver 1.2.0 : リクエスト先URLを変更しました。2009/12/08

注意

予告なくサービス停止または仕様変更する可能性があります。またこの検索結果の位置精度、潮位精度について何の保証もいたしません。 同様に予測した潮位の正確性を保証しません。厳密性を必要とする場合には海上保安庁に確認をお願いします。 また非合法活動や個人のプライバシーを侵害する目的で利用することはできません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。
  • TOP
  • APIとは


Copyright © ktailab.net. All Rights Reserved. テンプレート by ネットマニア