じゃらん 宿・ホテル予約サイト
 じゃらんnetトップ じゃらんnetのご利用方法 ご要望・お問合せ
宿・ホテル予約TOP > じゃらんWebサービス > 温泉検索API

じゃらんWebサービス/温泉検索API

APIリファレンス

じゃらんWebサービス 温泉検索API

温泉検索APIは、じゃらんnetに登録されている温泉地、温泉のコード、名称の情報を検索する機能を提供します。

リクエストURL

http://jws.jalan.net/APICommon/OnsenSearch/V1/

リクエストパラメーター

パラメーター 項目名 説明 必須
key APIキー APIを利用するためのキーです。
アカウント登録時に割り当てられるAPIキーを指定してください。
半角数字16桁以下
reg 広域コード 各広域に割り当てられたコードで検索を行います。 エリアから検索を行う場合、いずれか必須 エリアコード対応表を参照するか、 あるいはエリア検索APIでの検索結果を参考にしてください。
pref 都道府県コード 各都道府県に割り当てられたコードで検索を行います。
l_area 大エリアコード 都道府県を各地域ごとに分けたエリアのコードで検索を行います。
s_area 小エリアコード 大エリアを更に詳細に分けたエリアのコードで検索を行います。
onsen_q 泉質 泉質で絞り込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:単純温泉
2:アルカリ単純泉
3:単純炭酸泉
4:弱アルカリ性低張性泉
5:中性低張性高温泉
6:塩化物泉
7:ナトリウム塩化物泉
8:炭酸水素塩泉
9:炭酸鉄泉
10:硫酸塩泉
11:二酸化炭素泉
12:含鉄泉
13:含銅一鉄泉
14:硫黄泉
15:酸性泉
16:含アルミニウム泉
17:放射能泉
18:鉱泉
99:その他
start 表示From 出力されるデータの何件目から表示するかを指定します。 半角数字。
初期値:1
count 表示件数 出力されるデータの最大出力件数を指定します。
該当件数が出力件数よりも少ない場合は、全て表示されます。
1 〜 100までの半角数字。
初期値:10
xml_ptn 出力項目の範囲 レスポンスフィールドに出力される項目の範囲を指定します。 0:エリア内の温泉全て(初期値)
1:エリア内の温泉地全て

出力される範囲については、レスポンスフィールドの説明の「範囲」を参考にしてください。

サンプルリクエストURL

http://jws.jalan.net/APICommon/OnsenSearch/V1/?key=**********&l_area=010300&count=1&xml_ptn=1

※ keyの「**********」を取得したAPIキーに置き換えて実行してください。

レスポンスフィールド

フィールド 説明 出現回数 範囲
Results - - 1 - -
NumberOfResults 該当件数 半角数字 1 100 -
DisplayPerPage 表示件数 半角数字 1 5 -
DisplayFrom 表示From 半角数字 1 1 -
APIVersion APIバージョン 半角数字・記号 1 1.0 -
Onsen - - 表示件数分 - -
OnsenName 温泉名 全角漢字 1 丸駒温泉 0
OnsenNameKana 温泉名かな 全角かな 1 まるこまおんせん 0
OnsenID 温泉コード 半角数字 1 0042 0
OnsenAddress 温泉住所 全角・半角 1 北海道千歳市幌美内番外地 0
Area - - - - 0
Region 地域_広域エリア漢字名 全角・半角 1 北海道 0
Prefecture 地域_都道府県漢字名 全角・半角 1 北海道 0
LargeArea 地域_大エリア漢字名 全角・半角 1 石狩・空知・千歳 0
SmallArea 地域_小エリア漢字名 全角・半角 1 支笏湖・千歳 0
NatureOfOnsen 泉質 全角・半角 1 塩化物泉 0
OnsenAreaName 温泉地名 全角・半角 1 支笏湖畔の温泉 1
OnsenAreaNameKana 温泉地名かな 全角かな 1 しこつこはんのおんせん 1
OnsenAreaID 温泉地コード 半角数字 1 50024 0
OnsenAreaURL 温泉地ページURL 半角英数記号(URL) 1 http://www.jalan.net/JwsRedirect.do?
key=guest&rd_key=NTAwMjQgICAgIDAxMDI=
1
OnsenAreaCaption コピー 全角・半角 1 千歳市の西端に位置する支笏湖の東岸に支笏湖温泉、対岸の恵庭岳の麓に丸駒温泉と伊藤温泉がある。支笏湖温泉の泉質は重曹泉で、別名「美人の湯」といわれ入浴後は肌がスベスベになる。丸駒温泉と伊藤温泉の露天風呂はともに支笏湖と岩で区切られているだけで、まるで湖の中の温泉につかっているようだ。 1

サンプルレスポンス

検索条件:
大エリア=石狩・空知・千歳、範囲=エリア内の温泉地全て
での検索結果です。

<?xml version="1.0" encoding="UTF-8" ?>
<Results xmlns="jws">
    <NumberOfResults>23</NumberOfResults>
    <DisplayPerPage>1</DisplayPerPage>
    <DisplayFrom>1</DisplayFrom>
    <APIVersion>1.0</APIVersion>
    <Onsen>
        <OnsenName>丸駒温泉</OnsenName>
        <OnsenNameKana>まるこまおんせん</OnsenNameKana>
        <OnsenID>0042</OnsenID>
        <OnsenAddress>北海道千歳市幌美内番外地</OnsenAddress>
        <Area>
            <Region>北海道</Region>
            <Prefecture>北海道</Prefecture>
            <LargeArea>石狩・空知・千歳</LargeArea>
            <SmallArea>支笏湖・千歳</SmallArea>
        </Area>
        <NatureOfOnsen>塩化物泉</NatureOfOnsen>
        <OnsenAreaName>支笏湖畔の温泉</OnsenAreaName>
        <OnsenAreaNameKana>しこつこはんのおんせん</OnsenAreaNameKana>
        <OnsenAreaID>50024</OnsenAreaID>
        <OnsenAreaURL>http://www.jalan.net/JwsRedirect.do?key=guest&rd_key=NTAwMjQgICAgIDAxMDI=</OnsenAreaURL>
        <OnsenAreaCaption>千歳市の西端に位置する支笏湖の東岸に支笏湖温泉、対岸の恵庭岳の麓に丸駒温泉と伊藤温泉がある。支笏湖温泉の泉質は重曹泉で、別名「美人の湯」といわれ入浴後は肌がスベスベになる。丸駒温泉と伊藤温泉の露天風呂はともに支笏湖と岩で区切られているだけで、まるで湖の中の温泉につかっているようだ。</OnsenAreaCaption>
    </Onsen>
</Results>

エラー

じゃらんWebサービスは共通のエラーを返します。
詳しくは、ガイドラインをごらんください。


ビジネスホテル高級ホテル温泉・露天風呂ペットとホテル宿・ホテル一覧レンタカーツアー航空券高速バス・夜行バス旅行・観光ガイド