川崎です。Hack for Japan の一環として、新しい API を公開しました。

じゃらん http://www.jalan.net/ では、東北地方太平洋沖地震で被災された方々の
住居支援を目的として、一時避難としてご利用頂けるように、全国の宿泊施設のご協力により
１泊１名あたり 3,000 円以下を中心とした「被災地支援プラン」を提供しています。
本プランの背景・概要については、ニュースリリース を参照ください。

（※備考）なお、今回のプランでは、１泊１名あたりのプラン料金が 3,000 円以下の場合、
          システム利用料をリクルートが負担します。

メディアテクノロジーラボでは、本プランを検索する専用 API を作成しました。
この API 自体も、川崎が先週末の Hack for Japan のハッカソンで開発したものですが、
Hack for Japan の取り組みは今後も継続されます。本 API もご利用ください。

KML ファイルで地図上にプロット

XML 形式の API に加えて、対象の全ての宿を含む KML ファイルも作成しました。
全国で、多くの宿・ホテルにご協力いただいていることが分かります。（3/23 18:00現在 395件）
本当にありがとうございます。

http://api.hack4jp.rws.jp/jalan/shien/v1_kml/all.kml は Google Earth で開けます。

http://maps.google.co.jp/maps?q=http%3A//api.hack4jp.rws.jp/jalan/shien/v1_kml/all.kml
から、Google Maps でも開けます。（3/30 追記。n さん情報ありがとうございます）

本プラン・API が、少しでも、被災者の方・避難者の方のお役に立てれば幸いです。

じゃらん　東北地方太平洋沖地震＜被災者支援プラン＞API（Hack for Japan 用）

じゃらん 東北地方太平洋沖地震＜被災者支援プラン＞ で公開されている宿・ホテルの各プランを、
都道府県単位で検索または全件取得するための API です。（開発：メディアテクノロジーラボ）
利用上、ご不明な点がありましたら、MTL のお問合せページ よりお知らせ下さい。

リクエストURL

http://api.hack4jp.rws.jp/jalan/shien/v1/

リクエストパラメーター

パラメーター	項目名	説明	必須	値
key	APIキー	APIを利用するためのキーです。 アカウント登録 画面より取得できます。	◯	本APIに限り、 『guest』も利用可能です
xml_ptn	出力項目の範囲	レスポンスフィールドに出力される 項目の範囲を指定します。	◯	『2』プラン名まで含む （今回は『2』固定）
pref	都道府県コード	各都道府県に割り当てられたコードで 検索を行います。（半角数字6桁）	pref または mode いずれか 必須	『010000』北海道 『470000』沖縄県 エリアコードマスター を参照してください。
mode	検索モード	全件出力の場合は『all』を指定して下さい。		『all』全国を対象 無指定：都道府県検索

レスポンスフィールド

レスポンスは XML 形式で、基本的に通常のじゃらんWebサービスと同じフォーマットです。
詳細は、じゃらんWebサービス　宿表示API　アドバンス のリファレンスページを参照して下さい。
主なレスポンスフィールドは、以下の通りです。
ただし、下記『※』印のフィールドは、本 API のみの追加項目です。

フィールド	説明	例
Results
Hotel	（ホテル数分繰り返す）
HotelName	宿名漢字	ホテルオークラ札幌
HotelDetailURL	宿詳細ページURL	http://…
extension	※
lat	※ 緯度（世界測地系）	43.059010765
lng	※ 経度（世界測地系）	141.350471531
pref	※ JIS 都道府県コード	01
prefJalan	※ じゃらん都道府県コード	010000
Plan	（プラン数分繰り返す）
PlanName	プラン名	【被災地の方へ】…
RoomName	部屋名	スカンジナビアハリウッドツイン…
PlanDetailURL	宿詳細ページURL	http://…

サンプルレスポンス

以下のような XML 形式のデータがレスポンスとなります。

<?xml version="1.0" encoding="UTF-8" ?>
<Results xmlns="jws">
  <NumberOfResults>393</NumberOfResults>
  <DisplayPerPage>393</DisplayPerPage>
  <DisplayFrom>1</DisplayFrom>
  <APIVersion>1.2</APIVersion>
  <Hotel>
    <HotelID>362862</HotelID>
    <HotelName>ホテルオークラ札幌</HotelName>
    <HotelDetailURL>http://www.jalan.net/uw/uwp3000/uww3001.do?yadNo=362862</HotelDetailURL>
    <extension>
      <lat>43.059010765</lat>
      <lng>141.350471531</lng>
      <pref>01</pref>
      <prefJalan>010000</prefJalan>
    </extension>
    <Plan>
      <PlanCD>01143198</PlanCD>
      <PlanName>【被災地の方へ】緊急支援・長期滞在プラン【朝食付】</PlanName>
      <RoomCD>0181707</RoomCD>
      <RoomName>スカンジナビアハリウッドツイン（１室２名利用）28平米天井2m62cm</RoomName>
      <PlanDetailURL>http://www.jalan.net/uw/uwp3200/uww3201init.do?yadNo=362862&planCd=01143198&roomTypeCd=0181707</PlanDetailURL>
            ：
            ：（以下略）

実際のリクエストURL

なお、本 API は、Access-Control-Allow-Origin: * として提供しています。
モダンブラウザの JavaScript では、クロスドメイン XHR で取得することができます。
Flash の方は、http://api.hack4jp.rws.jp/jalan/crossdomain.xml をご利用下さい。

全国・全件の XML を取得する場合、実際の URL は以下の通りです。
（API キーは『guest』が利用可能です）

http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&mode=all

都道府県単位の XML を取得する場合は、実際の URL は以下の通りです。
（現時点で対象の宿がない都道府県も、今後、随時、追加されていきます→全都道府県が揃いました）

http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=010000 - 北海道
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=020000 - 青森県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=030000 - 岩手県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=040000 - 宮城県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=050000 - 秋田県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=060000 - 山形県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=070000 - 福島県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=080000 - 栃木県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=090000 - 群馬県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=100000 - 茨城県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=110000 - 埼玉県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=120000 - 千葉県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=130000 - 東京都
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=140000 - 神奈川県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=150000 - 山梨県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=160000 - 長野県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=170000 - 新潟県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=180000 - 富山県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=190000 - 石川県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=200000 - 福井県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=210000 - 静岡県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=220000 - 岐阜県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=230000 - 愛知県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=240000 - 三重県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=250000 - 滋賀県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=260000 - 京都府
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=270000 - 大阪府
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=280000 - 兵庫県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=290000 - 奈良県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=300000 - 和歌山県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=310000 - 鳥取県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=320000 - 島根県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=330000 - 岡山県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=340000 - 広島県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=350000 - 山口県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=360000 - 徳島県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=370000 - 香川県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=380000 - 愛媛県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=390000 - 高知県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=400000 - 福岡県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=410000 - 佐賀県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=420000 - 長崎県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=430000 - 熊本県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=440000 - 大分県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=450000 - 宮崎県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=460000 - 鹿児島県
http://api.hack4jp.rws.jp/jalan/shien/v1/?key=guest&xml_ptn=2&pref=470000 - 沖縄県

追記

2011.03.25 - <lat> <lng> 要素を修正しました。
2011.03.30 - pref 都道府県パラメタ仕様を訂正（下線）。<prefJalan> 要素を追加しました。