使用说明
用于匹配酒店所属城市和行政区等信息。当用户选择城市后，在此处获取对应的城市id用作搜索API的入参。接入方如果有自己的城市体系，需要根据此文件做mapping。
部分城市数据的城市id是8位的，这是因为这些数据本身是行政区，但作为城市进行维护。为了使行政区唯一化，在行政区原本id的前面加了其所属城市id，形成了8位的城市id。8位和4位的城市id都能用于搜索，但对应于{hotelId}.xml(酒店详情)的只有4位的行政区id。
欢迎使用新接口：hotel.static.city
输入参数
文件地址： https://[服务器域名]/xml/v2.0/hotel/geo_{lang}.xml
响应结果
根节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| HotelGeoList | Geo列表 | HotelGeo[] | N | 参考HotelGeo节点 |
HotelGeo节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| @Country | 国家 | String(20) | N | |
| @ProvinceId | 省份编号 | String(20) | N | |
| @ProvinceName | 省份名称 | String(20) | N | |
| @CityName | 城市名称 | String(20) | N | |
| @CityCode | 城市编码 | String(20) | N | |
| Districts | 行政区列表 | Location[] | Y | 参考Location节点 |
| CommericalLocations | 商业区 | Location[] | Y | 参考Location节点 |
| LandmarkLocations | 标志物 | Location[] | Y | 参考Location节点 |
Location节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| @Id | 位置编号 | Int | N | |
| @Name | 位置名称 | String(20) | N |
输入示例
https://[服务器域名]/xml/v2.0/hotel/geo_cn.xml
输出示例
<HotelGeos> <HotelGeoList> <HotelGeo Country="中国" ProvinceName="北京" ProvinceId="0100" CityName="北京" CityCode="0101"> <Districts> <Location Id="0028" Name="昌平区"/> <Location Id="0003" Name="朝阳区"/> <Location Id="0005" Name="崇文区"/> </Districts> <CommericalLocations> <Location Id="010186" Name="安贞"/> <Location Id="010120" Name="八大处"/> <Location Id="010132" Name="白河湾/云蒙山"/> </CommericalLocations> <LandmarkLocations> <Location Id="0005" Name="东方广场"/>< Location Id="0006" Name="中国国际展览中心"/> <Location Id="0007" Name="中国国际贸易中心"/> </LandmarkLocations> </HotelGeo> </HotelGeoList> </HotelGeos>
注意事项
文档中字段为”@”开头的是xml标签中的一个属性值。