楽天グループのウェブサービス/API/商品データベース。アフィリエイトにも対応
楽天ウェブサービス 楽天ウェブサービス

BETA

my Rakuten | 楽天市場へ
ウェブサービス規約 | ヘルプ
ウェブサービストップ 楽天市場 RMSパートナー 楽天アフィリエイトを利用
トップ > 楽天トラベル施設検索API
楽天ウェブサービス
オンラインドキュメント
楽天ウェブサービス規約
FAQ
クレジット表示
ウェブサービスチームブログ
旧ブログ
楽天市場系API
楽天商品検索API
楽天ジャンル検索API
楽天商品コード検索API
楽天商品ランキングAPI
楽天プロダクト製品検索API
楽天プロダクト製品詳細API
楽天プロダクトジャンル情報API
楽天プロダクトメーカー情報API
楽天ブックス系API
楽天ブックス総合検索API
楽天ブックス書籍API
楽天ブックスCD検索API
楽天ブックスDVD/Blu-ray検索API
楽天ブックス洋書検索API
楽天ブックス雑誌検索API
楽天ブックスゲーム検索API
楽天ブックスソフトウェア検索API
楽天ブックスジャンル検索API
楽天オークション系API
楽天オークション商品検索API
楽天オークション商品コード検索API
楽天オークションジャンル検索API
楽天トラベル系API
楽天トラベル施設検索API
楽天トラベル施設情報API
楽天トラベル空室検索API
楽天トラベル地区コードAPI
楽天トラベルキーワード検索API
楽天トラベルホテルチェーンAPI
楽天トラベルランキングAPI
>> 楽天トラベル系APIサンプル集
その他のAPI
楽天GORAゴルフ場検索API
楽天GORAゴルフ場詳細API
楽天GORAプラン検索API
楽天ダイナミックアドAPI
楽天ダイナミックアドAPI トラベル

提供API
楽天トラベル施設検索API (version:2009-10-20)
楽天トラベル施設検索API とは
楽天トラベル施設検索APIは、楽天トラベルの施設を施設番号、緯度経度、区分コードなどで検索し、施設情報を取得することが可能なAPIです。
>> サンプルコードはこちら(楽天トラベルへ)
 
アカウント情報
デベロッパーIDの確認ヘルプ
アフィリエイトIDの確認ヘルプ
■リクエストURL(REST/JSON形式の場合)
http://api.rakuten.co.jp/rws/3.0/rest?[parameter]=[value]…
http://api.rakuten.co.jp/rws/3.0/json?[parameter]=[value]…

※JSONP形式は、JSON形式で入力パラメーターにcallBackを指定することで出力されます。

たとえば、以下の3つのような場合のリクエストURLは下記になります。(実際には改行せずに1行につなげてリクエストしてください。)
(1)田沢湖の宿を検索する場合
http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=SimpleHotelSearch
&version=2009-10-20
&largeClassCode=japan
&middleClassCode=akita
&smallClassCode=tazawa
(2)東京駅の半径1Km圏内の宿を検索する場合
http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=SimpleHotelSearch
&version=2009-10-20
&latitude=128440.51
&longitude=503172.21
&searchRadius=1
(3)施設番号123456の宿と654321の宿を検索する場合
http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=SimpleHotelSearch
&version=2009-10-20
&hotelNo=123456,654321
短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。
■SOAPについて
SOAPを用いることで、より高度なアプリケーションの開発が可能となります。
SOAPに関しての詳細は「楽天トラベル施設検索API(SimpleHotelSearch)SOAP開発用」をご覧ください。
■入力パラメーター
楽天トラベル施設検索API(SimpleHotelSearch) 入力パラメーター version:2009-10-20
区分 ID 項目名 フィールド名
(括弧内は
最大
バイト数)
必須 デフォルト 備考





|

|
1 デベロッパID developerId String --- デベロッパーID
2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID
3 操作 operation String --- 使用するAPIの操作名:SimpleHotelSearch
4 コールバック関数名 callBack String - 指定無し JSONPとして出力する際のコールバック関数名
(UTF-8でURLエンコードした文字列)
英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上

|







|

|
1 バージョン version String --- 2009-10-20
2 大区分コード largeClassCode String
(*1)
(*2)
--- 国などを示すコード。地区コード一覧は地区コードAPI(GetAreaClass) より取得してください。
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
(*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。
3 中区分コード middleClassCode String
(*1)
(*2)
--- 都道府県などを示すコード。コード一覧は地区コードAPI(GetAreaClass) より取得してください。
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
(*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。
4 小区分コード smallClassCode String
(*1)
(*2)
--- 市など示すコード。コード一覧は地区コードAPI(GetAreaClass) より取得してください。
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
(*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。
5 細区分コード detailClassCode String
(*1)
(*2)
--- 駅や詳細地域などを示すコード。コード一覧は地区コードAPI(GetAreaClass) より取得してください。
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
(*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。
6 施設番号 hotelNo int(10)
(*1)
--- 楽天トラベルにおける施設を特定するためのNo
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。

このフィールドは15個まで指定することができます。
例)&hotelNo=12345,54321
7 緯度 latitude decimal
(*1)
--- 日本測地系(Tokyo Datum)、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。
例)128216.17
ただし、datumTypeに1を指定した場合は、
世界測地系、単位は度で指定すること。
例)35.6065914
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
8 経度 longitude decimal
(*1)
--- 日本測地系(Tokyo Datum)、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。
例)503259.29
ただし、datumTypeに1を指定した場合は、
世界測地系、単位は度で指定すること。
例)139.7513225
(*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号>緯度経度>区分コード]となります。
9 検索半径 searchRadius int - 1 緯度経度検索時の検索半径(単位km)
0.1以上、3.0以下であり、小数点以下は1桁までであること
10 絞込み条件 squeezeCondition String - --- kinen:禁煙ルーム internet:インターネットが出来る部屋
daiyoku:大浴場あり onsen:温泉


このフィールドは複数指定することができます。
例)禁煙ルームのある温泉宿
&squeezeCondition=kinen,onsen
11 キャリア情報 carrier int(1) - 0 PC用の情報を返すのか、モバイル用の情報を返すのかを選択
0:PC
1:mobile
12 緯度経度タイプ datumType int(1) - 2 入力及び出力パラメータの緯度経度タイプを指定する。
1:世界測地系、単位は度。
2:日本測地系、単位は秒。
13 取得ページ page int - 1 取得対象のページ数。
1以上、100以下の整数であること。(*1)

(*1)緯度経度検索でallReturnFlagが指定されていた場合、
pageとhitsは無効になります。
14 1ページあたりの取得件数 hits int - 30 1ページ毎の取得件数を制限するパラメータ。
1以上、30以下の整数であること。(*1)

(*1)緯度経度検索でallReturnFlagが指定されていた場合、
pageとhitsは無効になります。
15 施設画像サイズ hotelThumbnailSize int(1) - 2 出力パラメータの施設画像サムネイルURLの画像サイズを指定する。
1:小
2:中
3:大
16 返却情報タイプ responseType int(1) - middle 出力パラメータの返却情報タイプを指定する。
small:最低限の情報のみ
middle:中くらい
large:すべての情報
17 ソート sort String - standard standard:おすすめ順(*1)
+roomCharge:最安値料金(安い順)
-roomCharge:最安値料金(高い順)

(*1)おすすめ順とは・・・
■区分コード、施設番号による検索の場合■
standard:施設番号順

■経度緯度による検索の場合■
standard:指定された座標から近い順
18 全件返却フラグ allReturnFlag int(1) - --- 条件に該当する情報を全件返却するフラグ。(*1)(*2)
1:全件返却

(*1)緯度経度検索のときのみ有効。
(*2)allReturnFlagが指定されていた場合、pageとhitsは無効になります。
■出力パラメーター

※ 返却タイプ値によって、返却される情報が変化します。

楽天トラベル施設検索API(SimpleHotelSearch) 出力パラメーター version:2009-10-20
区分 ID 分類 small middle large 項目名 フィールド名 備考





|

|
1 Arg --- User-Agent Valueにはユーザのユーザエージェントが表示される
2 --- developerId ValueにはデベロッパーIDが表示される
3 --- affiliateId Valueにはユーザの指定したアフィリエイトIDが表示される
4 --- operation Valueにはユーザの指定した操作名が表示される
5 --- version Valueにはユーザの指定した操作のバージョンが表示される
6 Status --- Status Success / NotFound / ServerError / ClientError / Maintenance のいずれか
7 StatusMsg --- StatusMsg Statusに特化したメッセージを出力



1 全体情報
pagingInfo
検索結果総数 recordCount 検索結果のレコード件数
2 総ページ数 pageCount 最大100
3 ページ番号 page 現在のページ番号
4 ページ内結果開始番号 first 検索結果の何件目からか
5 ページ内結果終了番号 last 検索結果の何件目までか

|







|
1 施設情報
hotel
施設基本情報
hotelBasicInfo
施設番号 hotelNo
2 施設名称 hotelName
3 施設情報ページURL hotelInformationUrl 入力パラメーターにアフィリエイトIDが含まれていた場合、
アフィリエイトURLとなります。(*1)

(*1)carrierがモバイルの場合、
ダイナミックパッケージ宿泊プラン一覧ページは
日付を御入力頂いた後にプラン一覧が出力されます。
4 宿泊プラン一覧ページURL planListUrl
5 ダイナミックパッケージ
宿泊プラン一覧ページURL
dpPlanListUrl
6 お客様の声ページURL reviewUrl
7 施設かな名称 hotelKanaName
8 施設特色 hotelSpecial
9 最安料金 hotelMinCharge 1部屋1泊あたり、税・サービス料込みの最安値の目安
10 緯度 latitude datumType=1の場合:世界測地系(WGS)、単位は度
datumType=2の場合:日本測地系(Tokyo Datum)、単位は秒、小数点以下がミリ秒
11 経度 longitude datumType=1の場合:世界測地系(WGS)、単位は度
datumType=2の場合:日本測地系(Tokyo Datum)、単位は秒、小数点以下がミリ秒
12 郵便番号 postalCode
13 住所1 address1
14 住所2 address2
15 施設電話番号 telephoneNo
16 ファックス番号 faxNo
17 施設へのアクセス access
18 駐車場情報 parkingInformation
19 最寄駅名称 nearestStation
20 施設画像URL hotelImageUrl
21 施設画像サムネイルURL hotelThumbnailUrl
22 部屋画像URL roomImageUrl
23 部屋画像サムネイルURL roomThumbnailUrl
24 施設提供地図画像URL hotelMapImageUrl
25 投稿件数 reviewCount
26 ★の数(総合) reviewAverage ★の見方について
27 お客さまの声(1件目) userReview お客さまの声の最新の1件目を表示します。
28 評価詳細情報
hotelRatingInfo
★の数(サービス) serviceAverage ★の見方について
29 ★の数(立地) locationAverage
30 ★の数(部屋) roomAverage
31 ★の数(設備・アメニティ) equipmentAverage
32 ★の数(風呂) bathAverage
33 ★の数(食事) mealAverage
34 施設詳細情報
hotelDetailInfo
宿泊予約センター電話番号 reserveTelephoneNo 楽天価格での予約が電話で可能です。
35 中区分コード middleClassCode 都道府県などを示すコード。
コード一覧は地区コードAPI(GetAreaClass) より取得してください。
36 小区分コード smallClassCode 都道府県などを示すコード。
コード一覧は地区コードAPI(GetAreaClass) より取得してください。
37 地区名 areaName
38 ホテル種別コード hotelClassCode
39 チェックイン時刻 checkinTime HH:MM
40 チェックアウト時刻 checkoutTime HH:MM
41 最終チェックイン時刻 lastCheckinTime HH:MM
42 設備情報
hotelFacilitiesInfo
部屋数 hotelRoomNum
43 部屋設備・備品 roomFacilities
44 > 項目名 item
45 館内設備 hotelFacilities
46 > 項目名 item
47 食事場所について aboutMealPlace
48 > 朝食 breakfastPlace
49 > 夕食 dinnerPlace
50 風呂について aboutBath
51 > 種類 bathType
52 > 泉質 bathQuality
53 > 効能 bathBenefits
54 周辺のレジャーについて aboutLeisure
55 身障者設備 handicappedFacilities
56 > 項目名 item
57 スタッフの言語レベルについて linguisticLevel
58 宿泊条件・決済関連
hotelPolicyInfo
条件・注意事項・備考 note
59 キャンセルポリシー cancelPolicy
60 使用可能なカード availableCreditCard
61 > カード card
62 カード利用についての注意事項 aboutCreditCardNote
63 ポイント加算について aboutPointAdd 楽天スーパーポイント以外のポイントサービスについての情報
64 マイレージ加算について aboutMileageAdd
65 特典・その他
hotelOtherInfo
特典 privilege
66 その他情報 otherInformation
■アフィリエイトに関して
デベロッパーは、楽天トラベル施設検索APIからアフィリエイトURLを取得することが可能です。リンク先にそのアフィリエイトURLを指定することで、楽天アフィリエイト経由の成果報酬を獲得することができます。
アフィリエイトURLを作るには、APIの入力パラメーターに「アフィリエイトID」を含めてリクエストしてください。APIの出力に「アフィリエイトURL」が含まれます。
入力パラメーターcarrierでPCが指定された場合でもモバイルが指定された場合でも同様の方法でアフィリエイトURLを作成することができます。(2008年11月現在)
■エラー
エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。
Statusでの表示 内容
NotFound 検索結果が存在しない。
ServerError 楽天ウェブサービス側のエラー。
ClientError デベロッパーの入力に起因するエラー。
Maintenance メンテナンス。
■過去のバージョン
本APIの過去のバージョンは下記からご覧いただけます。

個人情報保護方針
Copyright (c) 1997-2012 Rakuten, Inc. All Rights Reserved.