jalan/api/common/onsen_search/v1

エリア検索API

温泉地、温泉のコード、名称の一覧を取得します。

じゃらん Web サービス

api URL

api url
http://jws.jalan.net/APICommon/OnsenSearch/V1/
format
xml
method
GET
認証
不要
実行制限
なし
公式ドキュメント
http://www.jalan.net/jw/jwp0100/jww0104.do

parameter set

parameter value 省略 説明
key
MyApiKey-key をセット 		必須 APIキー。アカウント登録時に取得したキー。
[MyApiKey-key]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
reg 可 広域コード。エリア検索APIで取得できる。
pref 可 都道府県コード。エリアコード対応表もしくはエリア検索APIで取得できる。
l_area 可 大エリアコード。エリアコード対応表もしくはエリア検索APIで取得できる。
s_area 可 小エリアコード。エリアコード対応表もしくはエリア検索APIで取得できる。
onsen_q 可 泉質。
start 可 該当結果全体に対して、何番目の結果から出力するか。整数。
count 可 １回のコールで何件分取得するか。1～100までの整数。
xml_ptn 可 レスポンスフィールドに出力される項目の範囲。

取得形式 :

call results

[call update]ボタンを押してください。ここに結果が表示されます。

  • このデータは、jsonpで取得しjabascriptオブジェクトに変換されたものを再度json形式に変換した結果です。
  • 受信されるデータと厳密に同じでないことをご理解ください。

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

開発メンバー間でパラメータの指定例をメールで送信したり、ブログやホームページでApiの説明を書く際にお使いください。
※パラメータにApiキーなどが含まれる場合はご注意ください。

  • javascriptでは桁数の大きな数値で値がズレることがあります。
  • 例えば、twitterの id_str と id です。
  • id_str は文字列型ですので正しい値が表示されます。
  • id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
  • id_str と id が異なる場合は、id_str を信用してください。
  • 試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか？
  • javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
  • 本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。