1. 地图导航-限行查询（restriction-restrictionInfo）

1.1 用户界面

手机

适用产品：智能助手，搜索

适用产品：语音助手

1.2 请求

城市限行查询请求

请求报文样例：

{
    "slots": {
        "beginDate": {
            "name": "beginDate",
            "slotType": "string",
            "values": [{
                "real": "2019-01-07"
            }]
        },
        "endDate": {
            "name": "endDate",
            "slotType": "string",
            "values": [{
                "real": "2019-01-08"
            }]
        },
        "city": {
            "name": "city",
            "slotType": "string",
            "values": [{
                    "real": "北京}
                ]
            }
        }

成员名称	描述	是否必选	类型	取值范围
beginDate	起始时间	否	DateFormatString	/
endDate	结束时间	否	DateFormatString	/
city	城市。如：北京	否	String	最大长度：32

1.3 响应

查询一段时间内的每天的限行尾号

响应报文样例：

{
  "version": "1.0",
  "reply": {
    "displayText": "displayText",
    "commands": [
      {
        "head": {
          "namespace": "Render",
          "name": "DisplayTemplate"
        },
        "body": {
          "templateType": "rate-exchange",
          "templateContent": {
            "items": [
              {
                "city": "北京",
                "active": {
                  "date": "2019-01-07",
                  "number": "1和2",
                  "restrictTime": "9:00-18:00",
                  "restrictPlace": "北三环",
                  "restrictRule": "9:00-18:00北三环限行",
                  "remark": "",
                  "punishment": "",
                  "day": "MON"
                },
                "items": [
                  {
                    "date": "2019-01-07",
                    "number": "1和2",
                    "restrictTime": "9:00-18:00",
                    "restrictPlace": "北三环",
                    "restrictRule": "9:00-18:00北三环限行",
                    "remark": "",
                    "punishment": "",
                    "day": "MON"
                  },
                  {
                    "date": "2019-01-08",
                    "number": "1和2",
                    "restrictTime": "9:00-18:00",
                    "restrictPlace": "北三环",
                    "restrictRule": "9:00-18:00北三环限行",
                    "remark": "",
                    "punishment": "",
                    "day": "TUE"
                  }
                ]
              }
            ]
          }
        }
      }
    ]
  },
  "isEndSession": true,
  "errorCode": "0",
  "errorMessage": "OK"
}

成员名称	描述	是否必选	类型	取值范围
items	/	是	estrictionInfoMainItem[]	/
shortAnswer	播报语	否	string	最大长度：512

2. 查地图-周边信息（poi-poiSearchInfo）

2.1 请求

周边检索请求

请求报文样例：

{
    "slots": {
        "keyword": {
            "name": "keyword",
            "slotType": "string",
            "values": [{
                "real": "加油站"
            }]
        },
        "location": {
            "name": "location",
            "slotType": "string",
            "values": [{
                "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"39.915\",\"longitude\":\"116.404\"}"
            }]
        },
        "radius": {
            "name": "radius",
            "slotType": "string",
            "values": [{
                "real": "2000"
            }]
        }
    }
}

成员名称	描述	是否必选	类型	取值范围
keyword	检索关键字（如：加油站、地铁站，标识检索地点分类名称。）	是	string	最大长度：64
city	区域名称，如：南京市。	否	string	最大长度：64
location	设备的经纬度，用于标识检索位置。	是	Location	/
radius	检索半径，单位：米，缺省值为1000（如：1000，表示以检索位置为中心，1000米半径内的检索结果。）	否	string	最大长度：16

2.2 响应

周边检索信息

响应报文样例：

{
    "items": [{
        "displayName": "中国石化(宣武门加油站)",
        "distance": 1894,
        "poiLocation": {
            "locationSystem": "BD09LL",
            "latitude": "39.905898",
            "longitude": "116.385224"
        },
        "address": "北京市西城区宣武门东大街16号",
        "telephone": "(010)63021072",
        "detailInfo": {
            "price": "147.5",
            "shopHours": "11:00-14:00,17:00-21:00",
            "overallRating": "4.0",
            "tasteRating": "0",
            "serviceRating": "0",
            "environmentRating": "0",
            "facilityRating": "0",
            "hygieneRating ": "0",
            "technologyRating ": "0",
            "detailUrl": {
                "webURL": "https://detailUrl",
                "deepLink": {},
                "quickApp": {}
            },
            "contentTag": "有便利店"
        }
    }]
}

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

3. 地图导航-路况查询（trafficCondition-trafficConditionInfo）

3.1 请求

定位服务请求-路况信息查询

请求报文样例-根据指定道路名称查询该道路的路况：

{
    "slots": {
        "queryType": {
            "name": "queryType",
            "slotType": "integer",
            "values": [{
                "real": 0
            }]
        },
        "location": {
            "name": "location",
            "slotType": "string",
            "values": [{
                "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"39.915\",\"longitude\":\"116.404\"}"
            }]
        },
        "roadName": {
            "name": "roadName",
            "slotType": "string",
            "values": [{
                "real": "软件大道"
            }]
        },
        "city": {
            "name": "city",
            "slotType": "string",
            "values": [{
                "real": "南京市"
            }]
        }
    }
} {
    "slots": {
        "queryType": {
            "name": "queryType",
            "slotType": "integer",
            "values": [{
                "real": 1
            }]
        },
        "location": {
            "name": "location",
            "slotType": "string",
            "values": [{
                "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"39.915\",\"longitude\":\"116.404\"}"
            }]
        },
        "radius": {
            "name": "radius",
            "slotType": "integer",
            "values": [{
                "real": 200
            }]
        },
        "roadGrade": {
            "name": "roadGrade",
            "slotType": "integer",
            "values": [{
                "real": 0
            }]
        }
    }
}

成员名称	描述	是否必选	类型	取值范围
queryType	查询类型，0：根据指定道路名称查询该道路的路况；1：根据指定的位置信息查询区域范围内的路况。	否	/	/
location	设备的经纬度，用于标识检索位置，如果city字段未填，则使用location对应的城市信息作为city信息。	否	Location	/
roadName	要查询路况的道路名称	是	string	最大长度：32
city	要查询路况的道路所在的城市	否	string	最大长度：32
radius	要查询的区间的半径，单位：米。	否	int	/
roadGrade	区间查询时需要返回的道路等级道路等级对应表如下： 0：全部驾车道路 1：高速路 2：环路及快速路 3：主干路 4：次干路 5：支干路不传时默认值为：0。	否	int	枚举值： 0，1，2，3，4，5

3.2 响应

定位服务请求-路况信息查询

响应报文样例-根据指定道路名称查询该道路的路况：

{
    "trafficDescription": "软件大道:自东向西较为畅通;自西向东畅通;东向西,软件大道转盘附近拥堵。",
    "evaluation": {
        "status": 1,
        "description": "自东向西较为畅通;自西向东畅通"
    },
    "trafficDetails": [{
        "roadName": "软件大道",
        "congestionInfo": [{
            "description": "东向西,软件大道转盘附近",
            "status": 3,
            "speed": 13.45,
            "distance": 700,
            "trend": "加重"
        }]
    }]
}

响应报文样例-根据指定的位置信息查询区域范围内的路况：

{
    "trafficDescription": "该区域整体拥堵。京包高速：北向南,从开拓路5到京新高速拥堵。京新上地桥：北向南,京新上地桥拥堵。
    京新高速： 北向南,
    从京包高速到耳通百安拥堵。 小营西路： 西向东,
    上地三街附近拥堵。 ",
    "evaluation": {
        "status": 3,
        "description": "拥堵"
    },
    "trafficDetails": [{
            "roadName": "上地四街"
        },
        {
            "roadName": "京包高速",
            "congestionInfo": [{
                "distance": 1870,
                "speed": 8.45,
                "status": 3,
                "trend": "持平",
                "description": "北向南,从开拓路5到京新高速"
            }]
        },
        {
            "roadName": "京新上地桥",
            "congestionInfo": [{
                "distance": 1610,
                "speed": 7.79,
                "status": 3,
                "trend": "持平",
                "description": "北向南,京新上地桥"
            }]
        },
        {
            "roadName": "京新高速",
            "congestionInfo": [{
                "distance": 1870,
                "speed": 8.45,
                "status": 3,
                "trend": "持平",
                "description": "北向南,从京包高速到耳通百安"
            }]
        }
    ]
}

成员名称	描述	是否必选	类型	取值范围
trafficDescription	路况描述信息，如：“软件大道：软件大道转盘附近双向行驶缓慢”。	否	string	最大长度：10240
evaluation	道路交通状况的评价信息	否	TrafficEvaluation	/
trafficDetails	路况详细信息	否	TrafficDetail[]	/
link	跳转到开发者的链接	否	Interaction	/

4. 位置查询-逆地理编码（geocoder-geocoderInfo）

4.1 请求

定位服务请求-逆地理编码

请求报文样例：

{
    "slots": {
        "location": {
            "name": "location",
            "slotType": "string",
            "values": [{
                "real": "{\"locationSystem\":\"BD09LL\",\"latitude\":\"39.915\",\"longitude\":\"116.404\"}"
            }]
        },
        "radius": {
            "name": "radius",
            "slotType": "string",
            "values": [{
                "real": "2000"
            }]
        }
    }
}

成员名称	描述	是否必选	类型	取值范围
location	设备的经纬度，用于标识检索位置。	是	Location	/
radius	检索半径，单位：米，缺省值为1000（如：1000，表示以检索位置为中心，1000米半径内的检索结果。）	否	string	最大长度：16

4.2 响应

定位服务响应消息

响应报文样例：

{
    "poiLocation": {
        "locationSystem": "BD09LL",
        "latitude": "39.905898",
        "longitude": "116.385224"
    },
    "formattedAddress": "北京市东城区中华路甲10号",
    "business": "天安门,前门,和平门",
    "addressDetailInfo": {
        "country": "中国",
        "countryCode": 0,
        "province": "北京市",
        "city": "北京市",
        "district": "东城区",
        "town": "",
        "adcode": "110101",
        "street": "中华路",
        "streetNumber": "甲10号"
    }
}

成员名称	描述	是否必选	类型	取值范围
poiLocation	地理位置坐标	是	Location	/
formattedAddress	结构化地址信息，如：北京市东城区中华路甲10号。	是	string	最大长度：256
business	坐标所在商圈信息，如：百家湖，景枫。	否	string	最大长度：256
addressDetailInfo	详细地址信息	否	AddressDetailInfoItem	/

5. 结构

5.1 RestrictionInfoMainItem

单日尾号限行信息

成员名称	描述	是否必选	类型	取值范围
city	城市，如：北京	是	string	最大长度：16
active	问到那一天	是	RestrictionInfoItem	/
items	/	是	RestrictionInfoItem[]	/

5.2 RestrictionInfoItem

单日尾号限行信息：

成员名称	描述	是否必选	类型	取值范围
date	日期	否	DateFormatString	/
number	限行尾号。如：3和7，不限行，单号，双号	是	string	最大长度：16
restrictTime	限行时间，格式HH:mm-HH:mm。如：9:00-18:00	否	string	最大长度：256
restrictplace	限行区域。如：北三环	否	string	最大长度：256
restrictRule	限行时间和区域，包含了restrictTime和restrictPlace	否	string	最大长度：256
remark	其他说明	是	string	最大长度：256
punishment	处罚事项	是	string	最大长度：128
day	星期，如：MON	否	string	最大长度：16

5.3 PoiSearchInfoItem

周边检索结果信息

成员名称	描述	是否必选	类型	取值范围
displayName	地址简要名称（如：中国石化（宣武门加油站））	是	string	最大长度：32
distance	本地址距离设备坐标的直线距离（单位：米，如：810）	是	number	/
poiLocation	地理位置坐标	是	Location	/
address	详细地址（如：秦淮区中山南路501号通服大厦4层）	是	string	最大长度：256
telephone	电话号码（如：（010）63021072）	否	string	最大长度：32
detailInfo	周边检索结果详情	否	PoiDetailInfo	/
link	拉起导航的链接	否	Interaction	/

5.4 PoiDetailInfo

周边检索结果详情

成员名称	描述	是否必选	类型	取值范围
price	商户价格，如：120	否	string	最大长度：32
shopHours	营业时间，如：11:00-14:00，17:00-21:00	否	string	最大长度：256
overallRating	总体评分，4.8	否	string	最大长度：32
tasteRating	口味评分	否	string	最大长度：32
serviceRating	服务评分	否	string	最大长度：32
environmentRating	环境评分	否	string	最大长度：32
facilityRating	星级（设备）评分	否	string	最大长度：32
hygieneRating	卫生评分	否	string	最大长度：32
technologyRating	技术评分	否	string	最大长度：32
detailUrl	/	否	Interaction	/
contentTag	标签信息，如：交通便利，环境不错	否	string	最大长度：256

5.5 AddressDetailInfoItem

定位信息地址详情

成员名称	描述	是否必选	类型	取值范围
country	国家	否	string	最大长度：32
province	省名	否	string	最大长度：32
city	城市名	否	string	最大长度：32
district	区县名	否	string	最大长度：32
town	乡镇名	否	string	最大长度：32
street	街道名	否	string	最大长度：32
streetNumber	街道门牌号	否	string	最大长度：32
countryCode	国家码	否	string	最大长度：32
adcode	行政区划代码	否	string	最大长度：32

5.6 TrafficEvaluation

道路交通状况的评价信息

成员名称	描述	是否必选	类型	取值范围
status	道路的整体拥堵评价0：未知路况1：畅通2：缓行3：拥堵4：严重拥堵	否	int	枚举值： 0，1，2，3，4
description	路况整体评价的语义化描述	否	string	最大长度：10240

5.7 TrafficDetail

道路交通状况的详细信息

成员名称	描述	是否必选	类型	取值范围
roadName	道路名称	否	string	最大长度：32
congestionInfo	拥堵路段详情	否	CongestionInfo[]	/

5.8 CongestionInfo

道路拥堵详细信息

成员名称	描述	是否必选	类型	取值范围
description	路段拥堵语义化描述信息	否	string	最大长度：10240
status	路段拥堵评价0：未知路况1：畅通2：缓行3：拥堵4：严重拥堵	否	int	枚举值： 0，1，2，3，4
speed	平均通行速度	否	number	最大值：120
distance	拥堵距离	否	int	/
trend	较10分钟前拥堵趋势持平：与10分钟前变化不大缓解：较10分钟前拥堵有所缓解加重：较10分钟前拥堵加重。	否	string	最大长度：10240