このシリーズの1回目(ここ)で、じゃらんWebサービスの、じゃらん宿APIを使って、結果を表で書き出すプログラムを紹介しました。
なので、今回は、その呼び出す部分
http://jws.jalan.net/APILite/HotelSearch/V1/?key=guest&pref=130000&l_area=137100&s_area=137102&pict_size=1
について、説明してみたいと思います。
■じゃらんWebサービス
まず、これらのことについて書いてある、じゃらんWebサービスについては、
ここ http://jws.jalan.net/ws/viw/U00001
に書いてあります。
で、そこの説明によると、じゃらんWebサービス 宿表示APIとは、
宿表示APIは、じゃらんnetに公開されている宿泊施設の情報を検索する機能を提供します。
だそうです。
■呼び出し形式
HTTPのGet型で、引数を指定して、
http://jws.jalan.net/APILite/HotelSearch/V1/
を呼び出します。
引数は、リクエストパラメータとして、さきほどのAPIのページにかいてあります。
ちなみに、サンプルの
http://jws.jalan.net/APILite/HotelSearch/V1/?key=guest&pref=010000&l_area=012900&s_area=012911&h_type=1&start=1&count=1
の意味は、
keyはguest(固定)
県prefは 010000(北海道)
大エリアコードl_areaは012900(石狩・空知・千歳)
小エリアコードs_areaは012911(支笏湖・千歳)
宿タイプh_typeは1(旅館)
表示開始startは1件
表示件数countは1件
を示します。なお、 県、大エリアコード、小エリアコードについては、
ここ http://jws.jalan.net/content/data/area.html
に書いてあります。また、XML形式で入手したい場合は
ここ http://jws.jalan.net/content/data/area.xml
にあります。
■返り値
正常でもエラーでもXML形式で帰ってきます。
エラーの場合は、
エラーについて http://jws.jalan.net/ws/viw/U05001#002
を参照。
正常の場合は、
http://jws.jalan.net/ws/viw/U01001にサンプルレスポンスという形で、結果がでてますね。
で、そのタグの意味については、上のレスポンスフィールドのところに、書いてあるようです。
■そのほかのリクルートのWebサービスについて
これらは、Sun×RECRUIT Mash up Awardで、リクルートが提供するAPIのうちの1つです。
で、そのリクルート提供APIについて
ほかにあるのは、
●カーセンサーラボのAPI http://www.recruit.jp/mashup2006/api_car.html
→APIについては http://www.carsensorlab.net/webservice/
●スマッチWeb サービス(不動産物件情報)http://www.recruit.jp/mashup2006/api_smatch.html
→APIについては http://www.smatch.jp/edit/api/getBukkenInfo.html
そこのスマッチ! 物件検索APIとスマッチ! 住まいの相談、ブログ検索API
●フロム・エー ナビ API(の利用規約)http://www.recruit.jp/mashup2006/kiyaku_froma.html
→こいつの場合は、じゃらんなどと違い、認証キーがないと、
アクセスできないみたい。
となっているよーです。
以上、説明終わり!