1. 打车-地址列表查询(taxi-addressList)

1.1 用户界面

手机

适用产品: 语音助手,搜索

1.2 请求

打车地址列表查询请求

请求报文样例:

  1. {
  2. "slots": {
  3. "place": {
  4. "name": "place",
  5. "slotType": "string",
  6. "values": [{
  7. "real": "南京南站"
  8. }]
  9. },
  10. "deviceLocation": {
  11. "name": "deviceLocation",
  12. "slotType": "string",
  13. "values": [{
  14. "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"118.785645\",\"longitude\":\
  15. "32.039635\"}\"}
  16. ]
  17. }
  18. }
  19. }

成员名称描述是否必选类型取值范围
city城市 (如:北京,如果city和deviceLocation都有,优先使用city去获地址列表。)否string最大长度: 64
place地名 (如:南京南站)是string最大长度: 64
deviceLocation设备的经纬度,用于辅助识别地名。是Location/

1.3 响应

打车地址列表信息

响应报文样例:

  1. {
  2. "items": [{
  3. "displayName": "新接口正洪街",
  4. "distance": 7.89,
  5. "poiLocation": {
  6. "locationSystem": "BD09LL",
  7. "latitude": "118.785645",
  8. "longitude": "32.039635",
  9. "poiId": "2345"
  10. },
  11. "address": "秦淮区新街口正洪街"
  12. }]
  13. }

成员名称描述是否必选类型取值范围
items/是TaxiAddressInfoItem[]最大Item数: 15

2. 打车-预叫车:taxi-prepareInfo

2.1 用户界面

手机

适用产品: 语音助手,搜索,智能助手

2.2 请求

预叫车准备信息查询请求

请求报文样例:

  1. {
  2. "slots": {
  3. "srcLocation": {
  4. "name": "srcLocation",
  5. "slotType": "string",
  6. "values": [{
  7. "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"118.785645\",\"longitude\":\
  8. "32.039635\",\
  9. "poiId\":\"2345\"}\"}
  10. ]
  11. },
  12. "srcAddrDisplayName": {
  13. "name": "srcAddrDisplayName",
  14. "slotType": "string",
  15. "values": [
  16. {
  17. "real": "南京南站"
  18. }
  19. ]
  20. },
  21. "dstLocation": {
  22. "name": "srcLocation",
  23. "slotType": "string",
  24. "values": [
  25. {
  26. "real": "{\
  27. "locationSystem\": \"BD09LL\",\
  28. "latitude\": \"120.785645\",\
  29. "longitude\": \"33.039635\",\
  30. "poiId\": \"2346\"
  31. }\
  32. "
  33. }
  34. ]
  35. },
  36. "dstAddrDisplayName": {
  37. "name": "dstAddrDisplayName",
  38. "slotType": "string",
  39. "values": [{
  40. "real": "新接口步行街"
  41. }]
  42. }
  43. }
  44. }

成员名称描述是否必选类型取值范围
srcLocation起点位置(位置坐标)是Location/
srcAddrDisplayName出发地名称是string最大长度: 64
dstLocation终点位置(位置坐标)是Location
dstAddrDisplayName目的地名称是string最大长度: 64
productType产品类型(专车、快车、出租车)否string最大长度: 64
rideType运力类型(舒适、商务、豪华、快车、优享、出租车),为空时按快车>优享快车>出租车>舒适专车>商务专车>豪华专车>other优先级选一个类型。否string最大长度: 64
departureTime出行时间(出行时间。出行时间不同,预估价格不同,默认为当前时间。)否DateTimeFormatString/

2.3 响应

预叫车准备信息查询请求

请求报文样例:

  1. {
  2. "carImageUrl": {
  3. "small": {
  4. "url": "https://example.com/car_comfort_small@1x.png",
  5. "widthPixels": 72,
  6. "heightPixels": 72
  7. },
  8. "medium": {
  9. "url": "https://example.com/car_comfort_small@2x.png",
  10. "widthPixels": 172,
  11. "heightPixels": 172
  12. },
  13. "large": {
  14. "url": "https://example.com/car_comfort_small@3x.png",
  15. "widthPixels": 280,
  16. "heightPixels": 280
  17. }
  18. },
  19. "productType": "专车",
  20. "rideTypeDisplayNameCn": "舒适",
  21. "currencyCode": "CNY",
  22. "estimatePrice": 12.01,
  23. "timeInSecond": 15,
  24. "distanceInMeter": 8.02,
  25. "srcAddrDisplayName": "南京南站",
  26. "dstAddrDisplayName": "新接口步行街",
  27. "buttonLinkArray": [{
  28. "buttonImageURL": "",
  29. "buttonText": "叫车",
  30. "webURL": "",
  31. "deepLink": {
  32. "url": "OneTravel://flash/action?param1=xxx&param2=yyy",
  33. "appName": "滴滴出行",
  34. "appPackage": "com.didi.chuxing",
  35. "minVersion": "",
  36. "minAndroidAPILevel": "23"
  37. },
  38. "quickApp": {
  39. "url": "hap://app/com.example/home?biz=flash&action=call&slat=32.03766&slng=118.78706&tlng=
  40. 118.7909 & tlat = 32.024117 ",
  41. "minPlatformVersion": "",
  42. "minVersion": ""
  43. }
  44. }],
  45. "dynamic": 1.5
  46. }

成员名称描述是否必选类型取值范围
carImageUrl车型图片地址是ImageInfo/
productType产品类型(专车、快车、出租车)否string最大长度: 32
rideTypeDisplayNameCn运力类型(舒适、商务、豪华、快车、优享、出租)是string最大长度: 32
currencyCode货币类型(CNY:人民币)是string最大长度: 32
estimatePrice预估价格,单位:元(精确到两位小数点,出租车时可能没有估价,就空着。)否number/
timeInSecond行程预估耗时,单位:分钟(出租车时可能没有估价,就空着。)否long/
distanceInMeter预估里程,单位:千米(精确到两位小数点,出租车时可能没有估价,就空着。)否number/
srcAddrDisplayName出发地名称是string最大长度: 32
dstAddrDisplayName目的地名称是string最大长度: 32
buttonLinkArray跳转到应用链接(跳转到预估界面)是ButtonInteraction[]最大Item数: 16
dynamic动调倍数否number/

2.4 结构

TaxiAddressInfoItem

打车地址信息

成员名称描述是否必选类型取值范围
displayName地址简要名称(如:五道口购物广场)是string最大长度: 32
distance本地址距离设备坐标的直线距离(单位:千米,精确到两位小数,如:5.60)否number/
poiLocation地理位置坐标(位置坐标)是Location/
address详细地址(如:秦淮区中山南路501号通服大厦4层)是string最大长度: 256