ktailab日帰り温泉API

開発のねらい

日帰りで利用できる温泉は、「立ち寄り湯」とも呼ばれ、安い料金で気軽に利用できるのでとてもいいものです。しかし、どこにあるかが分かりにくいのが難点でした。日帰り温泉検索サービスで使用しているAPIを公開しますので、携帯やカーナビなどとリンクさせてご利用ください。

緯度経度を指定して付近の物件を検索するjspa.cgiと、名前または所在地を指定してマッチした物件を検索するjspa_byname.cgi があります。

2008/08/01:登録されている温泉施設の件数は約5200件です。

API仕様

URI : http://api.ktailab.net/cgi-bin/jspa.cgi?lat=$lat&lon=$lon$dist=$dist&apikey=000000000000000000

入力パラメータ :

lat=dd.ddddd（実数） - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。）
lon=ddd.ddddd（実数） - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。）
dist=d(整数) - 探索半径(単位はm)です。デフォルト(無指定)で10kmになります。
apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。正式APIkey発行手順はこちらをご覧ください。

出力形式 :

文字コード : UTF-8です。
フォーマット : XMLです。
- name - 温泉名です。
- addr - 日本語の所在地です。
- phone - 連絡先の電話番号です。
- lat - 緯度です。WGS84。
- lon - 経度です。WGS84。

URI : http://api.ktailab.net/cgi-bin/jspa_byname.cgi?name=$name&apikey=000000000000000000

入力パラメータ :

name - 温泉の名前または所在地です。UTF-8文字コードセットです。URLエンコード必要です。
apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。正式APIkey発行手順はこちらをご覧ください。

出力形式 :

文字コード : UTF-8です。
フォーマット : XMLです。
- name - 温泉名です。
- addr - 日本語の所在地です。
- phone - 連絡先の電話番号です。
- lat - 緯度です。WGS84。
- lon - 経度です。WGS84。
- guide - 一行の温泉ガイドです。

例

緯度経度指定(jspa.cgi)

名称指定(jspa_byname.cgi)

検索キーワード=横浜

変更履歴

ver 1.0.0 : ベータ版公開 2008/08/03
ver 1.2.0 : リクエスト先URLを変更しました。2009/12/08
ver 1.3.0 : jspa_byname.cgiを公開しました。2009/12/18

注意

予告なくサービス停止または仕様変更する可能性があります。またこの検索結果の位置精度、距離精度について何の保証もいたしません。同様に電話番号についても正確性を保証しません。間違い電話の可能性があります。また非合法活動や個人のプライバシーを侵害する目的で利用することはできません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。