じゃらんWebサービス／エリア検索API

国内宿泊

じゃらん宿表示API

空室検索API

エリア検索API

温泉検索API

じゃらんWebサービス　エリア検索API

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

リクエストURL

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

リクエストパラメーター

パラメーター	項目名	説明	必須	値
key	APIキー	APIを利用するためのキーです。アカウント登録時に割り当てられるAPIキーを指定してください。	○	半角数字16桁以下
reg	広域コード	各広域に割り当てられたコードで検索を行います。		半角数字2桁
pref	都道府県コード	各都道府県に割り当てられたコードで検索を行います。		半角数字6桁
l_area	大エリアコード	都道府県を各地域ごとに分けたエリアのコードで検索を行います。		半角数字6桁

サンプルリクエストURL

http://jws.jalan.net/APICommon/AreaSearch/V1/?key=**********&reg=40

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

レスポンスフィールド

フィールド	説明	型	出現回数	例
Results	-	-	1	-
APIVersion	APIバージョン	半角数字・記号	1	1.0
Area	-	-	1	-
Region	広域	-	表示広域数分	-
cd	広域コード	半角数字	1	01
name	広域名	全角漢字	1	北海道
Prefecture	都道府県	-	広域に含まれる都道府県数分	-
cd	都道府県コード	半角数字	1	010000
name	都道府県名	全角漢字	1	北海道
LargeArea	大エリア	-	都道府県に含まれる大エリア数分	-
cd	大エリアコード	半角数字	1	010200
name	大エリア名	全角漢字	1	札幌
SmallArea	小エリア	-	大エリアに含まれる小エリア数分	-
cd	小エリアコード	半角数字	1	010202
name	小エリア名	全角漢字	1	ススキノ・大通り

サンプルレスポンス

検索条件：
広域＝山陰・山陽
での検索結果です。

<?xml version="1.0" encoding="UTF-8" ?>
<Results xmlns="jws">
    <APIVersion>1.0</APIVersion>
    <Area>
        <Region cd="40" name="山陰・山陽">
            <Prefecture cd="310000" name="鳥取県">
                <LargeArea cd="310200" name="鳥取・岩美">
                    <SmallArea cd="310202" name="鳥取" />
                    <SmallArea cd="310205" name="岩美" />
                    <SmallArea cd="310208" name="八頭" />
                    <SmallArea cd="310211" name="浜村・鹿野" />
                </LargeArea>
                <LargeArea cd="310500" name="倉吉・三朝・湯梨浜">
                    <SmallArea cd="310502" name="はわい・東郷" />
                    <SmallArea cd="310505" name="三朝" />
                    <SmallArea cd="310508" name="倉吉・関金" />
                </LargeArea>
                <LargeArea cd="310800" name="米子・大山">
                    <SmallArea cd="310802" name="米子・皆生・境港" />
                    <SmallArea cd="310805" name="大山" />
                </LargeArea>
            </Prefecture>
            <Prefecture cd="320000" name="島根県">
                <LargeArea cd="320100" name="松江・安来・玉造・奥出雲">
                    <SmallArea cd="320102" name="松江・美保関・玉造" />
                    <SmallArea cd="320105" name="安来" />
                    <SmallArea cd="320111" name="奥出雲・雲南" />
                </LargeArea>
                <LargeArea cd="320400" name="出雲・大田・石見銀山">
                    <SmallArea cd="320408" name="出雲・大社・湯の川" />
                    <SmallArea cd="320411" name="大田・温泉津" />
                </LargeArea>
                <LargeArea cd="320500" name="益田・浜田・津和野">
                    <SmallArea cd="320505" name="浜田・江津・有福" />
                    <SmallArea cd="320508" name="津和野・益田" />
                </LargeArea>
                <LargeArea cd="320800" name="隠岐島">
                    <SmallArea cd="320802" name="島前" />
                    <SmallArea cd="320805" name="島後" />
                </LargeArea>
            </Prefecture>
            <Prefecture cd="330000" name="岡山県">
                <LargeArea cd="330200" name="岡山・玉野・牛窓">
                    <SmallArea cd="330202" name="岡山・玉野" />
                    <SmallArea cd="330205" name="牛窓・日生" />
                </LargeArea>
                <LargeArea cd="330500" name="倉敷・総社・井笠">
                    <SmallArea cd="330502" name="倉敷・児島・鷲羽山" />
                    <SmallArea cd="330505" name="総社・井原・笠岡" />
                </LargeArea>
                <LargeArea cd="330800" name="津山・美作三湯・蒜山">
                    <SmallArea cd="330802" name="湯原・蒜山高原" />
                    <SmallArea cd="330805" name="津山・奥津" />
                    <SmallArea cd="330808" name="美作・湯郷" />
                </LargeArea>
                <LargeArea cd="331100" name="高梁・新見・吉備高原">
                    <SmallArea cd="331102" name="高梁・川上・成羽" />
                    <SmallArea cd="331105" name="新見・阿哲" />
                </LargeArea>
            </Prefecture>
            <Prefecture cd="340000" name="広島県">
                <LargeArea cd="340300" name="福山・竹原・呉">
                    <SmallArea cd="340302" name="福山・尾道・しまなみ" />
                    <SmallArea cd="340305" name="三原・竹原" />
                    <SmallArea cd="340308" name="呉・江田島" />
                </LargeArea>
                <LargeArea cd="340600" name="庄原・三次・芸北">
                    <SmallArea cd="340602" name="庄原・帝釈峡・神石高原" />
                    <SmallArea cd="340605" name="三次" />
                    <SmallArea cd="340608" name="芸北" />
                </LargeArea>
                <LargeArea cd="340900" name="広島・宮島">
                    <SmallArea cd="340902" name="広島" />
                    <SmallArea cd="340905" name="宮島・廿日市" />
                </LargeArea>
            </Prefecture>
            <Prefecture cd="350000" name="山口県">
                <LargeArea cd="350300" name="岩国・柳井・周南">
                    <SmallArea cd="350302" name="岩国" />
                    <SmallArea cd="350305" name="柳井・周防大島" />
                    <SmallArea cd="350308" name="周南・湯野" />
                </LargeArea>
                <LargeArea cd="350600" name="山口・秋芳">
                    <SmallArea cd="350602" name="山口・湯田・防府" />
                    <SmallArea cd="350605" name="秋芳" />
                </LargeArea>
                <LargeArea cd="351000" name="萩・長門">
                    <SmallArea cd="351002" name="萩" />
                    <SmallArea cd="351005" name="長門" />
                </LargeArea>
                <LargeArea cd="351300" name="下関・宇部">
                    <SmallArea cd="351302" name="宇部" />
                    <SmallArea cd="351305" name="下関・長府・川棚" />
                </LargeArea>
            </Prefecture>
        </Region>
    </Area>
</Results>

エラー

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

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