開発のねらい
太陽が作る影の長さは、場所と時刻により変わります。これをWebApiで問い合わせることができるようにしました。以前から使っていた
計算式なのですが、APIとして公開します。場所(緯度、経度)を指定すると現時刻の影の方向と長さをレスポンスします。
API仕様
URI : http://api.ktailab.net/mountain/shadow.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です。
- date - 現日付です。YY/MM/DD形式。
- time - 現時刻です。24時間表示。午前5時前と午後7時以降は長さ0を返します。
- sun_direction - 太陽の方向です。90から270度までの整数。90は東、180は南、270は西を示します。
- shadow_length - 長さ1mの垂直な棒が作る影の長さです。(最大100m)
例
変更履歴
- ver 1.0.0 : ベータ版公開 2009/11/24
- ver 1.2.0 : リクエスト先URLを変更しました。2009/12/08
注意
予告なくサービス停止または仕様変更する可能性があります。またこの検索結果の位置精度、距離精度について何の保証もいたしません。
同様に観測結果の正確性を保証しません。厳密性を必要とする場合には気象庁に確認をお願いします。
また非合法活動や個人のプライバシーを侵害する目的で利用することはできません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。