全部产品
云市场

全域时空调度

更新时间:2020-03-05 21:27:58

1、服务介绍

1.1 产品定位

基于痛点,本需求基于POI资源库,融合物联网实时数据、高德地图能力,实现景区及消费场景的串联和关联推荐,缓解景区流量时空不平衡问题,提升全域消费指数和二销指数。

1.2 产品功能

  • 面向游客,基于旅游目的地景区、酒店、交通、餐饮等实时动态信息,并结合游客偏好/位置/计划,规划优选路线方案,并推荐目的地相关的公共服务数据(车位余量、厕所余量、营业时间)
  • 面向全域管理端,根据下辖景区拥挤度、整体引流目标,适当调整相关内容的权重,宏观调控旅游目的资源分配,避免部分景区过度拥堵。

2、接入指南

2.1 查询推荐景点

路径:/tourism/recommend/spot/query
版本:1.0.0

入参
参数 类型 是否必填 备注
userId String 外部ISV用户Id
groupId String 全域分组,如果尚未创建分组,需要找小二创建分组以及添加景点到分组
location String 用户所在位置经纬度,格式:经度,维度,逗号为英文逗号

出参

景点列表集合和对应推荐得分

参数 类型 备注
recommendSpotId String 推荐主数据景点Id
businessId String ISV景点Id
score String 推荐值

示例

入参示例

  1. {
  2. "userId":"xxxx",
  3. "location":"123.xxxx,34.xxxx",
  4. "groupId":"yyyy"
  5. }

出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": [{
  5. "recommendSpotId": "xxxx",
  6. "businessId":"pppp",
  7. "score": "0.87"
  8. }, {
  9. "recommendSpotId": "yyyy",
  10. "businessId":"qqqq",
  11. "score": "0.67"
  12. }]
  13. }

2.2 查询目的地详情

2.2.1 查询租户下全域分组列表

路径:/tourism/scenicspot/group/query
版本:1.0.0

入参

出参

全域分组信息列表

参数 类型 备注
groupId String 分组Id,系统生成
groupName Double 分组名称
capacity Integer 分组下可以绑定景点数量的上限
count Integer 当前已经绑定的景点数量

示例

入参示例

  1. {
  2. }

出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": [{
  5. "groupId": "xxxx",
  6. "groupName": "山西全域",
  7. "capacity":200,
  8. "count":130
  9. }, {
  10. "groupId": "yyyy",
  11. "groupName": "河南全域",
  12. "capacity":200,
  13. "count":130
  14. }]
  15. }

2.2.2 查询景点信息列表

路径:/tourism/scenicspot/query
版本:1.0.0

入参
参数 类型 是否必填 备注
nameLike String 景点名称模糊查询
province String 省份过滤
city String 市过滤
district String 区县过滤
pageNo Integer 页码,默认1
pageSize Integer 分页大小,默认100

出参

全域分组信息列表

参数 类型 备注
scenicSpotId String 主数据景点Id
name String 景点名称
aClass Integer 景区级别0-5A
address String 地址
province String 省份
city String
district String 区县
capacity Integer 景点容量
price Double 票价
longitude Double 经度
latitude Double 纬度
duration Integer 建议游玩时长,单位小时
season String 推荐游玩季节
status Integer 营业状态,1-营业中,0-停业中
extInfo String 扩展信息

示例

入参示例

  1. {
  2. "nameLike":"大鸿寨景区",
  3. "province":"河南省",
  4. "city":"许昌市",
  5. "district":"禹州市",
  6. "pageNo":1,
  7. "pageSize":100
  8. }

出参示例

  1. {
  2. "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
  3. "code": 200,
  4. "message": null,
  5. "localizedMsg": null,
  6. "data": {
  7. "data": [{
  8. "scenicSpotId": "411081XCSYZDHZJQ",
  9. "aClass": 4,
  10. "address": "河南省许昌市禹州市大鸿寨景区",
  11. "city": "许昌市",
  12. "district": "禹州市",
  13. "duration": 3,
  14. "extInfo": "08:00~17:30",
  15. "latitude": 34.235156,
  16. "longitude": 113.096406,
  17. "name": "许昌市禹州大鸿寨景区",
  18. "price": 50.0,
  19. "province": "河南省",
  20. "season": "1111",
  21. "status": 1
  22. }],
  23. "total": 1
  24. }
  25. }

2.2.3 查询景点信息

路径:/tourism/scenicspot/getbyid
版本:1.0.0

入参
参数 类型 是否必填 备注
scenicSpotId String IoT景点ID

出参

全域分组信息列表

参数 类型 备注
scenicSpotId String 主数据景点Id
name String 景点名称
aClass Integer 景区级别0-5A
address String 地址
province String 省份
city String
district String 区县
capacity Integer 景点容量
price Double 票价
longitude Double 经度
latitude Double 纬度
duration Integer 建议游玩时长,单位小时
season String 推荐游玩季节
status Integer 营业状态,1-营业中,0-停业中
extInfo String 扩展信息

示例

入参示例

  1. {
  2. "nameLike":"大鸿寨景区",
  3. "province":"河南省",
  4. "city":"许昌市",
  5. "district":"禹州市",
  6. "pageNo":1,
  7. "pageSize":100
  8. }

出参示例

  1. {
  2. "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
  3. "code": 200,
  4. "message": null,
  5. "localizedMsg": null,
  6. "data": {
  7. "data": [{
  8. "scenicSpotId": "411081XCSYZDHZJQ",
  9. "aClass": 4,
  10. "address": "河南省许昌市禹州市大鸿寨景区",
  11. "city": "许昌市",
  12. "district": "禹州市",
  13. "duration": 3,
  14. "extInfo": "08:00~17:30",
  15. "latitude": 34.235156,
  16. "longitude": 113.096406,
  17. "name": "许昌市禹州大鸿寨景区",
  18. "price": 50.0,
  19. "province": "河南省",
  20. "season": "1111",
  21. "status": 1
  22. }],
  23. "total": 1
  24. }
  25. }

2.2.4 添加景点到全域分组

注意:全域分组和景点是多对多的关系,一个景点可以添加到多个分组。
路径:/tourism/scenicspot/group/spot/add
版本:1.0.0

入参
参数 类型 是否必填 备注
groupId String 要绑定的分组Id
businessId String ISV景点Id
scenicSpotId String IoT主数据的景点Id

出参

示例

入参示例

  1. {
  2. "groupId":"xxx",
  3. "businessId":"yyy",
  4. "scenicSpotId":"zzz"
  5. }

出参示例

  1. {
  2. "code": 200,
  3. "message": "success"
  4. }

2.2.5 从全域分组删除景点

注意:全域分组和景点绑定是多对多的关系,删除的时候要一一删除。
路径:/tourism/scenicspot/group/spot/remove
版本:1.0.0

入参
参数 类型 是否必填 备注
groupId String 分组Id
businessId String ISV景点Id

出参

示例

入参示例

  1. {
  2. "groupId":"xxx",
  3. "scenicSpotId":"yyy"
  4. }

出参示例

  1. {
  2. "code": 200,
  3. "message": "success"
  4. }

2.2.6 查询分组下添加的景点列表

路径:/tourism/scenicspot/group/spot/query
版本:1.0.0

入参
参数 类型 是否必填 备注
groupId String 要绑定的分组Id

出参
参数 类型 备注
groupId String 分组Id
businessId String ISV景点Id
scenicSpotId String IoT主数据的景点Id

示例

入参示例

  1. {
  2. "groupId":"xxx"
  3. }

出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": [{
  5. "groupId": "xxxx",
  6. "scenicSpotId": "yyyy",
  7. "businessId":"zzzz"
  8. }, {
  9. "groupId": "xxxx",
  10. "scenicSpotId": "ffff",
  11. "businessId":"gggg"
  12. }]
  13. }