此请求在旅行用户搜索的酒店中发送。该响应包括给定坐标和半径的匹配酒店列表。酒店供应商仅在此区域返回房产。
utf - 8
酒店直接连接将相关信息发送到旅行供应商维护的URI。标准位置是：
https:// {servername} /同意/酒店/ v1 /
供应商确定URI并将其提供给在注册合作伙伴应用程序时使用的SAP Confor。
应用程序/ XML
具有基本凭据的授权标题。必需的。
请求将包含一个OTA_HotelSearchRQ父元素，包含以下属性：
的OTA_HotelSearchRQ父元素包含以下子元素：
| 元素 | 描述 |
|---|---|
| p | 销售点信息。包含一个来源子元素，用于指定请求的来源。有关的信息来源元素,看到源元素下表。 |
| 标准 | 客户提供的搜索条件。此父元素包含一个标准儿童元素。有关此子元素的信息，请参阅标准元素下表。 |
的来源元素指定请求的源。它有以下属性:
的来源元素包含以下元素:
| 元素 | 描述 |
|---|---|
| RequestorID | 公司标识符。如有必要，多个RequestorID可以发送元素。该元素具有以下属性: type：企业标识符的类型代码。应该是其中一个支持的ID类型代码． ID：公司标识符。 id_context.:企业标识符上下文。 |
| 元素 | 描述 |
|---|---|
| 位置 | 酒店搜索中心位置。Position一直发送，并且是LatLon格式(度数为浮点数)。它应该作为实际搜索的位置源。这个元素有两个属性: 纬度：酒店中心的纬度搜索。 经度：经度在酒店搜索中心。 |
| 地址 | 酒店搜索的地址信息。可选的。有关此父元素的子元素的信息，请参见地址元素下表。 |
| refpoint. | 搜索的参考点。可选的。该元素具有名称属性，包含所在城市，州和国家。示例：redmond，wa，美国 |
| HotelRef | 酒店信息。可选的。此元素可以具有以下属性： 酒店名称:客户提供的酒店名称。此属性仅在客户提供名称时显示。这个值应该被解释为“contains”样式匹配。 |
| 半径 | 酒店搜索半径从起始位置开始。这个元素有三个可能的属性: 距离：从定义的中心搜索的距离。 DistanceMeasure：使用距离值计算搜索半径时测量单位。值：miles = m，公里= k。如果不包括在内，则应使用以下属性： unitofmeasurecode.：衡量单位的代码。值：miles = 2，公里= 1 注意:只返回搜索范围内的酒店。您可以使用一个简单的框搜索。 |
| StayDateRange | 搜索的日期范围。包含开始和结束属性。格式:YYYY-MM-DD |
| 元素 | 描述 |
|---|---|
| 城市名称 | 用户正在搜索的城市的名称。 |
| CountryName | 该元素具有代码属性，包含用户正在搜索的国家/地区的两个字符国家代码。 |
帖子/同意/酒店/ v1HTTPS/1.1主持人：example.com.授权：基本…内容类型：应用程序/ XML内容长度：{内容体的长度}xmlns =“http://www.opentravel.org/OTA/2003/05”echotoken =.“abc123”时间戳=“2012-01-01T19：00：00”PrimaryLangID =“恩美”xmlns: xsi =“http://www.w3.org/2001/xmlschema-instance”XSI：Schemalocation =“http://www.opentravel.org/ota/2003/05 ../schemas/ota_hotelsearchrq.xsd”版本=“6.000”>类型=“4”ID =“7777777”id_context =.“myhotel”/>> < /来源<标准><标准><位置纬度=“45.1317”经度=“-86.1823”/><地址>名称=“美国MI帝国”/>< HotelRefHotelName =.“客栈”/><半径距离=“5”DistanceMeasure =“M”/>开始=“2012-08-15”结束=“2010-08-17”/> 供应商通过返回可能的搜索匹配列表来响应请求，结果集最多为1000个结果。
应用程序/ XML
响应将包括一个OTA_HotelSearchRS父元素，具有以下属性：
的OTA_HotelSearchRS父元素包含以下子元素：
| 元素 | 必须(必须包含值)? | 描述 |
|---|---|---|
| 成功 | N | 如果请求成功，则返回此元素。 |
| 特性 | 此元素包含一个财产返回的每个酒店属性的父元素。有关此父元素的子元素的信息，请参见财产元素下表。 |
的财产元素具有以下属性：
的财产元素具有以下子元素：
| 元素 | 描述 |
|---|---|
| 位置 | 酒店位置。这个元素有两个属性: 纬度：酒店的纬度。 经度：经度酒店。 |
| 地址 | 酒店的地址。可选的。如果您希望在搜索结果中显示地址，请提供此元素。有关此父元素的子元素的信息，请参见地址元素下表。 |
| tpa_extensions. | 有关此父元素的子元素的信息，请参见tpa_extensions元素下表。 |
| 元素 | 描述 |
|---|---|
| Streetnmbr. | 酒店的街道地址。 |
| 城市名称 | 这座城市酒店进来了。 |
| 后级码 | 酒店的邮政编码。 |
| CountryName | 该元素具有代码属性包含酒店的国家/地区代码。 |
| 元素 | 描述 |
|---|---|
| HotelImageUri. | 链接到与酒店相关的图片。响应中应返回酒店形象的完全限定url。图像大小必须是70像素宽和72像素高。图像不能大于8K字节。图片格式必须为gif或jpg。图像应该可以通过http和https协议访问。 |
| HotelPreference | 此元素包括客户的偏好级别为单个属性。指的是酒店直接连接代码对于可能的值。 |
| gds_infotype. | 这个父元素有MasterChainCode属性，包含双字母的GDS代码，可以访问所有由同一链所有或代表的不同酒店品牌的访问权限。的MasterChainCode让Concur自动决定为这家酒店发送什么优惠卡号。指的是酒店直接连接代码．此父元素包含一个gds_codes.元素，其中包含gds_code.元素。的gds_code.元素具有以下属性： GDS_PropertyCode：此属性让我们同意与其他结果相匹配（将GDS和HotelService汇率显示为一个项目）。最典型的是Northstar ID。如果提供GDS_Propertycode，则还必须提供GDS_NAME GDS_Name：相关GDS的名称。 |
| StarRating | 这家旅馆的星级数。可选的。可能的值:1 - 5 |
HTTPS/1.1200.行内容类型：应用程序/ XML内容长度：{内容体的长度}xmlns =“http://www.opentravel.org/OTA/2003/05”echotoken =.“abc123”时间戳=“2012-01-01T19：00：00”xmlns: xsi =“http://www.w3.org/2001/xmlschema-instance”XSI：Schemalocation =“http://www.opentravel.org/OTA/2003/05 . . /模式/ OTA_HotelSearchRS.xsd”版本=“6.000”><成功/><属性>ChainCode =“ZZ”酒店代码=“HTL1111”HotelName =.“HOTEL1”><位置纬度=“45.132”经度=“-86.1823”/><地址>masterchaincode =“ZZ”>gds_propertycode =“W1234567”GDS_Name =“worldspan”/><主演>4> < /属性ChainCode =“ZZ”酒店代码=“HTL2222”HotelName =.“HOTEL2”><位置纬度=“45.131”经度=“-86.1823”/><地址>ChainCode =“ZZ”酒店代码=“HTL3333”HotelName =.“HOTEL3”><位置纬度=“45.1317”经度=“-86.182”/><地址>