コンテンツ参照API
Content References APIを利用することで、Rapid施設 のコンテンツをより深く理解することができます。
Rapid Content APIで提供される 施設 に関する情報(施設 または客室レベルで利用可能なアメニティやサービス、付加価値、料金に含まれるアメニティなど)は、数値IDで表されています。Content References APIを使用して、属性IDとその意味のリストをself-serveに保存します。
参考文献の詳細
アメニティ
アメニティとは、旅行者が利用できる設備やサービスのことです。
Rapid Content APIsでは、id オブジェクト内の各アメニティについて、name、ローカライズされたvalue、および明示的なamenities(該当する場合)を提供しています。
アメニティは施設、客室、料金プランのレベルに応じて利用でき、有料であることや制限があることが明記されていない限り無料です。
- 施設 レベル: すべての旅行者がご利用いただける設備です。
- 客室レベル : 関連する客室にのみアメニティが適用されます。
- 料金レベル : 関連する料金プランにのみアメニティが適用されます。
amenities_property、amenities_rooms、およびamenities_rates オブジェクトを探してください。
各アメニティには、3つのフィールドが含まれています:
idnamehas_value
Content API レスポンスの例 :
"amenities": {
"9": {
"id": 9,
"name": "Fitness facilities"
},
"2820": {
"id": 2820,
"name": "Number of indoor pools -",
"value": 10
}
},アメニティカテゴリ
アメニティカテゴリを使用すると、関連するアメニティをグループ化して、表示、検索、またはフィルタリ ングできます。
Rapid Content APIにおいて、categories オブジェクトは、アメニティが属するカテゴリを表します。これにより、関連する設備をより簡単にグループ化して、表示、検索、またはフィルタリングを行うことができます。
Content API レスポンスの例 :
{
"12345": {
"property_id": "12345",
...
"amenities": {
"2070": {
"id": "2070",
"name": "Dry cleaning/laundry service",
"categories": [
"drycleaning_and_laundry_services"
]
}
}
}
}利用可能なカテゴリ
accessibilityaccessible_parkingaccessible_wheelchairair_conditioningairport_transferall_inclusivebarcasinocribdry_cleaning_laundrydryerelectric_charging_stationfree_airport_transferfree_all_mealsfree_breakfastfree_breakfast_1_or_2_guestsfree_dinnerfree_lunchfree_wifigymhot_tubkitchenmeeting_facilityocean_viewparkingpets_allowedspa_servicesswimming_poolwasherwater_parkwifi
属性
属性は、施設と滞在に適用されるポリシーと特徴を表します。
Rapid Content APIsでは、id オブジェクト内の属性について、name、ローカライズされたvalue、および(該当する場合)明示的なattributes を提供しています。
属性は施設レベルで利用でき、施設と滞在に適用されるポリシーと機能を表します。
general: 施設に適用される一般的なポリシー。pets: 施設 に適用されるペットに関する規定です。
attributes_generalおよびattributes_petsというオブジェクトを探してください。
各属性には、3つのフィールドが含まれています:
idnamehas_value
Content API レスポンスの例 :
"attributes": {
"general": {
"2549": {
"id": 2549,
"name": "No elevators"
},
"3357": {
"id": 3357,
"name": "Caters to adults only"
}
},
"pets": {
"51": {
"id": 51,
"name": "Pets allowed"
},
"2809": {
"id": 2809,
"name": "Dogs only"
}
}
},カテゴリ
各施設には、施設タイプを表す施設カテゴリーが 1 つだけ関連付けられています。
Rapid Content APIsでは、id オブジェクト内に、施設 カテゴリのname およびcategory の両方を提供しています。
各施設には、提供される施設タイプを表す施設カテゴリーが 1 つだけ関連付けられています。
categoryというオブジェクトを探してください。
各カテゴリには2つのフィールドが含まれています:
idname
Content API レスポンスの例 :
"category": {
"id": 1,
"name": "Hotel"
},参照用に施設カテゴリーのリストを以下に示します。
id | name |
|---|---|
| 0 | 施設 |
| 1 | ホテル |
| 2 | モーテル |
| 3 | リゾート |
| 4 | イン |
| 5 | ベッド & ブレックファスト |
| 6 | ゲストハウス |
| 7 | コンドミニアム |
| 8 | オールインクルーシブ |
| 9 | キャビン |
| 10 | 山荘 |
| 11 | コテージ |
| 12 | ホステル |
| 13 | 牧場 |
| 14 | ヴィラ |
| 15 | ロッジ |
| 16 | アパートメント |
| 17 | バケーションホーム (一棟貸し) |
| 18 | ハウスボート |
| 20 | 旅館 |
| 21 | ツリーハウス |
| 22 | アパートスタイルホテル |
| 23 | コンドミニアム リゾート |
| 24 | キャンプ場 |
| 25 | リヤド |
| 26 | ホスタル |
| 29 | カントリーハウス |
| 30 | ペンション |
| 31 | ポサーダ (ポルトガル) |
| 32 | ポサーダ (ブラジル) |
| 33 | レジデンス |
| 34 | アフィッタカメレ |
| 36 | 古城ホテル |
| 37 | サファリ / テンタロー |
| 39 | 宮殿ホテル |
| 40 | アグリツーリズム |
| 41 | クルーズ |
| 42 | ホリデーパーク |
| 43 | カプセルホテル |
| 44 | トレーラーハウス |
チェーン参照
ホテルチェーンとは、複数のブランドを関連付けることができる親会社を表します。
Rapid Content APIでは、認識されたすべてのチェーンのチェーン参照マッピングを提供しています。
各施設は、親ホテルチェーンを持つ 1 つのブランドのみに関連付けられます。
Content API レスポンスの例 :
"chain": {
"id": -6,
"name": "Hyatt Hotels"
},
"brand": {
"id": 2209,
"name": "Hyatt Place"
},画像
画像は、施設のどのエリアの画像かによって、カテゴリー分けされています。
Rapid Content APIsでは、各 施設 画像について、category フィールドにカテゴリIDを、caption フィールドにカテゴリ名を指定しています。部屋の画像にはキャプションも付いています。
imagesというオブジェクトを探してください。
各画像カテゴリには、2つのフィールドが含まれています:
idname
Content API レスポン スの例 :
"images": [
{
"caption": "Featured Image",
"hero_image": true,
"category": 3,
"links": {
"350px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_b.jpg"
},
"70px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_t.jpg"
},
"1000px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_z.jpg"
}
}
},
]現地払いタイプ
現地払いタイプは、宿泊施設で発生した料金または宿泊施設で支払う必要がある料金に対して利用可能な支払い方法を表します。
Rapid Content APIでは、id オブジェクト内のname オブジェクトを通じて、サイト内決済タイプの「types」およびローカライズされた「onsite_payments」を提供しています。
現地払いタイプは施設レベルで提供され、宿泊施設で発生した料金または宿泊施設で支払う必要がある料金に対して利用可能な支払い方法を表します。
onsite_payment_typesというオブジェクトを探してください。
各支払い方法には、2つのフィールドが含まれています:
idname
Content API レスポンスの例 :
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},統計
統計は施設レベルの情報で、階数や客室数などを表します。
Rapid Content APIsでは、id オブジェクト内の統計情報について、name、ローカライズされたvalue、および(該当する場合)明示的なstatistics を提供しています。
統計は施設レベルで利用でき、階数や客室数などのデータを表します。
statisticsというオブジェクトを探してください。
各統計データには、3つのフィールドが含まれています:
idnamevalue
Content API レスポンスの例 :
"statistics": {
"52": {
"id": 52,
"name": "Total number of rooms -",
"value": "820"
},
"54": {
"id": 54,
"name": "Number of floors -",
"value": "38"
}
},テーマ
テーマは、通常のターゲット層であるお客様のタイプや施設の雰囲気を表します。
Rapid Content APIでは、id オブジェクト内に、テーマのname およびローカライズされたthemes の両方を提供しています。
テーマは施設レベルで利用でき、通常のターゲット層であるお客様のタイプや施設の雰囲気を表します 。1 つの施設に複数のテーマを関連付けることができますが、テーマが設定されていない施設もあります。
themesオブジェクトを探してください。
各テーマには2つのフィールドが含まれています:
idname
Content API レスポンスの例 :
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},客室からの眺望
客室からの眺望は、特定の客室から見える眺望を表します。
Rapid Content APIでは、id オブジェクトから利用可能なビューのname およびローカライズされたviews を提供しています。
room_viewsというオブジェクトを探してください。
各ビューには2つのフィールドが含まれています:
idname
Content API レスポンスの例 :
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},対応言語
「話されている言語」とは、施設 のスタッフが話している言語を指します。
Rapid Content APIでは、id オブジェクトから、spoken_languages および話されている言語のローカライズされた名称を提供しています。
spoken_languagesというオブジェクトを探してください。
各言語には2つのフィールドが含まれています:
idname
Content API レスポンスの例 :
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},