goo blog サービス終了のお知らせ 

ウィリアムのいたずらの、まちあるき、たべあるき

ウィリアムのいたずらが、街歩き、食べ物、音楽等の個人的見解を主に書くブログです(たま~にコンピューター関係も)

じゃらんWebサービスを使ってみる(その2:API部分の説明)

2006-06-23 16:55:09 | JavaとWeb

 このシリーズの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
→こいつの場合は、じゃらんなどと違い、認証キーがないと、
 アクセスできないみたい。

となっているよーです。




以上、説明終わり!

この記事についてブログを書く
  • X
  • Facebookでシェアする
  • はてなブックマークに追加する
  • LINEでシェアする
« Google Desktop APIを使うと... | トップ | ソフトバンク、ケータイにフ... »
最新の画像もっと見る

JavaとWeb」カテゴリの最新記事