高德官网地址是: https://lbs.amap.com/api/webservice/summary/ 。
高德Web服务API向开发者提供HTTP接口,开发者可通过这些接口使用各类型的地理数据服务,返回结果支持JSON和XML格式。
Web服务API对所有用户开放。使用高德服务之前,需要申请应用Key。不同类型用户可获取不同的数据访问能力。
我们在使用高德官方提供的WEB服务时,常规流程如下图所示:
调用高德服务时,需要每次把认证key一起发送到服务方。
虽然只是简单地在URL后面放上密钥,但每个接口的密钥字段名、值都是不一样的。如果需要调用多个接口,那开发者就需要在程序中保存、维护这些参数。
在很多情况下,一个账号的密钥可以调用 A、B、C、D多个接口,如果开发者想精细管理,比如某个小组只能调用A,某个小组只能调用BC,这样的情况只能自己编码进行权限管理。
哪些IP可以使用您的密钥调用接口,哪些IP不能调用?这个看似简单的功能,很多API服务商却没有提供。
假设一个密钥在多个开发组中共享,每个小组每天能使用多少次调用,并发又能到多少? 因为API服务商通常对密钥有个总流控,您也不希望某个小组代码有问题而把其他小组的业务全阻塞了。
一个密钥在什么时候,什么IP调用了接口,出入参数分别是什么?对不起,目前绝大部份API服务商没有对此记录。当您对调用量有疑问而希望服务商和您对账时,由于日志的缺失,这将是一笔糊涂账。
比如您同时在用百度和高德的【IP地址查询】接口,由于两个服务的调用额度、并发限制可能不同,您可以在易源设置这两个节点的负载权重从而分流。
比如您同时在用百度和高德的【IP地址查询】接口,它们的输入和输出字段是不一样的。您可以通过易源对这两个节点的输入和输出做字段映射、代码级转换,从而把它们的输入输出完全统一。
项目中同时在用ABC三个接口,A挂了就走B,B再挂了就走C。需要定期检测节点的恢复情况。
对于上一小节提到的问题,解决如下:
通过连接器创建接入点,设置私有用户调用权限控制可使用哪些后端数据。
如果单纯的字段映射不能应对复杂情况,我们还可以使用【嵌入代码】方式直接修改输入、输出内容。
某个节点熔断后,易源会根据权重或嵌入的代码,将请求数据转至正常的后端节点。
如果在同一个局域网下进行压力测试,直连时程序做充分优化,易源中转比直连方式的多消耗时间<1ms。网站或APP的响应时间在100ms-1000ms之间是可以接受的,也就是易源增加的时间是整体流程的0.01至0.001的比率,几乎可以忽略不计。这点开销,就像开车从北京到西安有1000公里,中间因为修路多走了1公里,总共由1000到1001公里,多走这1公里对全局可以忽略不计。
对于高德连接器,易源的IP是:
接口地址:http://route.showapi.com/2127-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 ip String 123.125.71.44 是 需要查询的IP地址
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-1","my_appId","my_appSecret") .addTextPara("ip","123.125.71.44") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1 info String OK 是否成功的标志 infocode String 10000 是否成功的编码 province String 北京市 city String 北京市 adcode String 110000 rectangle String 116.0119343,39.66127144;116.7829835,40.2164962 区间范围 ...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "4412631427db44f488aef13d4f5b8f98",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"info": "OK",
"infocode": "10000",
"province": "北京市",
"city": "北京市",
"adcode": "110000",
"rectangle": "116.0119343,39.66127144;116.7829835,40.2164962"
}
}
接口地址:http://route.showapi.com/2127-2 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 city String 320582是 输入城市的编码。具体参数值请见帮助文档,对应文档中的adcodeextensions String base base否 可选值:base/all base:返回实况天气,为默认值。 all:返回预报天气。
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-2","my_appId","my_appSecret") .addTextPara("city","320582") .addTextPara("extensions","base") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1count String 1info String OKinfocode String 10000lives Object[] 实况天气数据信息- 0 Object - province String 江苏 省份名- city String 张家港市 城市名- adcode String 320582 区域编码- weather String 晴 天气现象(汉字描述)- temperature String 22 实时气温,单位:摄氏度- winddirection String 北 风向描述- windpower String ≤3 风力级别,单位:级- humidity String 19 空气湿度- reporttime String 2019-10-29 15:49:09 数据发布的时间...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "d46d425d2c874636885a149abe324c21",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"count": "1",
"info": "OK",
"infocode": "10000",
"lives": [
{
"province": "江苏",
"city": "张家港市",
"adcode": "320582",
"weather": "晴",
"temperature": "22",
"winddirection": "北",
"windpower": "≤3",
"humidity": "19",
"reporttime": "2019-10-29 15:49:09"
}
]
}
}
接口地址:http://route.showapi.com/2127-3 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 location String 116.3057764,39.98641364是 中心点坐标。 经度在前,纬度在后。经度和纬度用","分割。 经纬度小数点后不得超过6位。radius String 1000 1000否 半径。单位:米,最大取值5000米。level String 5 5否 道路等级。下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103国道) 3:高速辅路(G6辅路) 4:主要道路(长安街、三环辅路路) 5:一般道路(彩和坊路) 6:无名道路extensions String base base否 可选值:base/all...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-3","my_appId","my_appSecret") .addTextPara("location","116.3057764,39.98641364") .addTextPara("radius","1000") .addTextPara("level","5") .addTextPara("extensions","base") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1info String OK OK代表成功infocode String 10000 10000代表成功trafficinfo Object - description String 北四环路:展春二桥附近自西向东严重拥堵,海淀桥附近自西向东行驶缓慢;善缘街:自北向南畅通,反向缓慢,中国电子大厦附近自东向西严重拥堵;万泉河路:万泉河桥附近自南向北行驶缓慢;丹棱街:自西向东畅通,反向缓慢;海淀中街:理想国际大厦附近自北向南行驶缓慢;海淀大街:中钢国际广场附近自西向东行驶缓慢;颐和园路:北京大学西门附近双向行驶缓慢。 路况综述- evaluation Object - expedite String 70.00% 畅通所占百分比- congested String 26.00% 缓行所占百分比- blocked String 4.00% 拥堵所占百分比- unknown String 0.00% 未知路段所占百分比- status String 2 0:未知 1:畅通 2:缓行 3:拥堵 4:严重拥堵- description String 轻度拥堵 道路描述...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "eeb6dde5d1c04cd28f9a4e69937cc23a",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"info": "OK",
"infocode": "10000",
"trafficinfo": {
"description": "北四环路:展春二桥附近自西向东严重拥堵,海淀桥附近自西向东行驶缓慢;善缘街:自北向南畅通,反向缓慢,中国电子大厦附近自东向西严重拥堵;万泉河路:万泉河桥附近自南向北行驶缓慢;丹棱街:自西向东畅通,反向缓慢;海淀中街:理想国际大厦附近自北向南行驶缓慢;海淀大街:中钢国际广场附近自西向东行驶缓慢;颐和园路:北京大学西门附近双向行驶缓慢。",
"evaluation": {
"expedite": "70.00%",
"congested": "26.00%",
"blocked": "4.00%",
"unknown": "0.00%",
"status": "2",
"description": "轻度拥堵"
}
}
}
}
接口地址:http://route.showapi.com/2127-4 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 address String 北京市朝阳区阜通东大街6号是 结构化地址信息。 规则遵循:国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦,如:北京市朝阳区阜通东大街6号。如果需要解析多个地址的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持 10 个地址进进行"|"分割形式的请求。city String 否 可选输入内容包括:指定城市的中文(如北京)、指定城市的中文全拼(beijing)、citycode(010)、adcode(110000),不支持县级市。当指定城市查询内容为空时,会进行全国范围内的地址转换检索。batch String false 否 批量查询控制 batch 参数设置为 true 时进行批量查询操作,最多支持 10 个地址进行批量查询。 batch 参数设置为 false 时进行单点查询,此时即使传入多个地址也只返回第一个地址的解析查询结果。...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-4","my_appId","my_appSecret") .addTextPara("address","北京市朝阳区阜通东大街6号") .addTextPara("city","") .addTextPara("batch","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000count String 1 返回结果数目 , 返回结果的个数。geocodes Object[] 地理编码信息列表- 0 Object - building Object 楼信息列表- name - type - name String[] 建筑名称 , 例如:万达广场- type String[] 类型 , 例如:科教文化服务;学校;高等院校- township - location String 116.483038,39.990633 经纬度坐标- street String 阜通东大街 街道 , 例如:阜通东大街- neighborhood Object 社区信息列表- name - type - name String[] 社区名称 ,例如:北京大学- type String[] POI类型 , 例如:科教文化服务;学校;高等院校- number String 6号 门牌,例如:6号- country String 中国 国家,国内地址默认返回中国- city String 北京市 地址所在的城市名,例如:北京市- citycode String 010 城市编码,例如:010- level String 门牌号 匹配级别,参见 地理编码匹配级别列表- formatted_address String 北京市朝阳区阜通东大街|6号 结构化地址信息 : 省份+城市+区县+城镇+乡村+街道+门牌号码- province String 北京市 地址所在的省份名 , 例如:北京市。此处需要注意的是,中国的四大直辖市也算作省级单位。- adcode String 110105 区域编码 , 例如:110101- district String 朝阳区 地址所在的区 , 例如:朝阳区status String 1 返回值为 0 或 1,0 表示请求失败;1 表示请求成功。info String OK 当 status 为 0 时,info 会返回具体错误原因,否则返回“OK”。详情可以参阅info状态表...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "d574e43830dd4f84a7c63eb1956685f9",
"showapi_res_body": {
"infocode": "10000",
"count": "1",
"geocodes": [
{
"building": {
"name": [],
"type": []
},
"township": [],
"location": "116.483038,39.990633",
"street": "阜通东大街",
"neighborhood": {
"name": [],
"type": []
},
"number": "6号",
"country": "中国",
"city": "北京市",
"citycode": "010",
"level": "门牌号",
"formatted_address": "北京市朝阳区阜通东大街|6号",
"province": "北京市",
"adcode": "110105",
"district": "朝阳区"
}
],
"status": "1",
"info": "OK"
}
}
接口地址:http://route.showapi.com/2127-5 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 origin String 117.600244,40.417801是 出发点 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位destination String 117.500244,40.417801是 目的地 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-5","my_appId","my_appSecret") .addTextPara("origin","117.600244,40.417801") .addTextPara("destination","117.500244,40.417801") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000count String 1 返回结果总数目status String 1 返回状态 --1:成功;0:失败route Object 路线信息列表- paths Object[] 步行方案- 0 Object - duration String 11945 步行时间预计 单位:秒- distance String 14931 起点和终点的步行距离 单位:米- steps Object[] 每段步行方案- 0 Object - orientation String 西北 方向- duration String 8151 此路段预计步行时间- distance String 10189 此路段距离- polyline String 117.596884,40.41599;117.596892,40.415968;117.596888,40.41592;117.59678,40.415816;117.595608,40.415425;117.595156,40.415156;117.595026,40.414631;117.594905,40.414444;117.594796,40.414214;117.594852,40.41388;117.595013,40.413411;117.595243,40.41263;117.595412,40.412205;117.595543,40.411675;117.595859,40.41079;117.595829,40.410569;117.595339,40.409779;117.595104,40.409262;117.594957,40.408811;117.594822,40.408524;117.594601,40.408155;117.594128,40.407504;117.594071,40.407378;117.593958,40.406953;117.59385,40.406662;117.59385,40.406662;117.593828,40.406441;117.593798,40.40638;117.593707,40.406302;117.593585,40.40625;117.593333,40.406198;117.593082,40.406185;117.592839,40.406211;117.592487,40.406285;117.592487,40.406285;117.592287,40.406363;117.591914,40.406589;117.591623,40.406693;117.591172,40.406784;117.590135,40.407057;117.589939,40.407101;117.589679,40.407131;117.589379,40.407131;117.589158,40.407166;117.588685,40.407305;117.588112,40.407552;117.587457,40.407769;117.587344,40.407791;117.586892,40.407817;117.586758,40.407812;117.586246,40.40773;117.585842,40.407752;117.585664,40.407747;117.585252,40.407717;117.584588,40.407704;117.584366,40.407674;117.584206,40.407622;117.583672,40.407227;117.583477,40.407105;117.582765,40.406927;117.582561,40.406853;117.582148,40.406662;117.582148,40.406662;117.581697,40.406445;117.581215,40.406172;117.580994,40.406115;117.580773,40.406102;117.580651,40.406115;117.580538,40.406155;117.580417,40.406211;117.580339,40.406272;117.579944,40.406714;117.579371,40.407287;117.579271,40.407352;117.579158,40.407413;117.578876,40.407509;117.578537,40.407569;117.57803,40.407582;117.577739,40.407582;117.577296,40.407556;117.576923,40.407513;117.576671,40.407513;117.576198,40.407609;117.57592,40.407687;117.5748,40.407895;117.572513,40.408268;117.571506,40.408416;117.57072,40.408477;117.570169,40.408481;117.569874,40.408472;117.569592,40.408442;117.567912,40.408016;117.567057,40.407839;117.566727,40.407799;117.566424,40.407808;117.566302,40.407856;117.566233,40.407921;117.566189,40.408034;117.566133,40.408429;117.566072,40.408598;117.565842,40.408958;117.565629,40.409232;117.565447,40.409392;117.56474,40.409783;117.564631,40.409831;117.564449,40.409865;117.564258,40.409852;117.563767,40.409709;117.563433,40.409583;117.562656,40.409219;117.561237,40.408763;117.560707,40.408607;117.560512,40.408576;117.560295,40.408572;117.560295,40.408572;117.559978,40.408611;117.559757,40.408694;117.559666,40.408746;117.559549,40.408859;117.559436,40.408989;117.559345,40.409136;117.559288,40.409306;117.559275,40.409401;117.559266,40.409588;117.55928,40.409692;117.559314,40.409822;117.559379,40.409961;117.559462,40.410091;117.559714,40.410378;117.560117,40.410725;117.560742,40.411198;117.561011,40.411445;117.561124,40.411632;117.561367,40.412057;117.561619,40.412444;117.561667,40.412569;117.561654,40.412669;117.561632,40.412721;117.561549,40.412795;117.561428,40.412839;117.561306,40.412865;117.560937,40.412891;117.560395,40.412943;117.560013,40.412964;117.558724,40.41293;117.558628,40.412938;117.558542,40.413003;117.558481,40.413099;117.558442,40.413273;117.558446,40.413464;117.558477,40.413589;117.558568,40.413763;117.559089,40.41454;117.559622,40.41553;117.559696,40.415694;117.559722,40.415786;117.559722,40.415859;117.559696,40.415955;117.559596,40.416124;117.559466,40.416272;117.558945,40.416675;117.558763,40.416797;117.558572,40.416875;117.557856,40.417096;117.557613,40.417196;117.556832,40.417591;117.556285,40.417917;117.556285,40.417917;117.556107,40.417999;117.556107,40.417999;117.555981,40.418034;117.55559,40.418082;117.555412,40.418134;117.555169,40.418281;117.555056,40.418368;117.555017,40.418424;117.554948,40.418542;117.554878,40.418832;117.554787,40.419102;117.554774,40.419449;117.554722,40.419596;117.554501,40.419952;117.554423,40.42013;117.554353,40.42026;117.553967,40.420694;117.55385,40.42089;117.553676,40.421337;117.55365,40.421441;117.553615,40.422187;117.553624,40.422448;117.553685,40.423012;117.553694,40.423147;117.553676,40.42332;117.553568,40.423872;117.553568,40.423872;117.553485,40.424266;117.553485,40.424266;117.553416,40.424562;117.553416,40.424562;117.553333,40.424948;117.553333,40.424948;117.55299,40.426063;117.552921,40.426554;117.552938,40.427582;117.552938,40.427582;117.552891,40.427904;117.552843,40.428064;117.552769,40.42822;117.552582,40.428481;117.552582,40.428481;117.552387,40.428698;117.551966,40.429063;117.551697,40.42924;117.551163,40.429544;117.550981,40.429605;117.550768,40.429648;117.550499,40.429661;117.549488,40.429674;117.549045,40.429661;117.548572,40.429622;117.547578,40.429423;117.547036,40.429375;117.546641,40.429375;117.546185,40.429401;117.545794,40.429466;117.545503,40.429536;117.544922,40.42974;117.544666,40.429857;117.544453,40.429978;117.544453,40.429978;117.544297,40.430113;117.544145,40.430317;117.544032,40.430538;117.543915,40.430864;117.543915,40.430864;117.54385,40.431124;117.543793,40.431484;117.543793,40.431484;117.543672,40.432457;117.543633,40.432617;117.543581,40.432739;117.543407,40.432977;117.543207,40.433194;117.542886,40.433437;117.542812,40.43352;117.542812,40.43352;117.542756,40.433576;117.542574,40.433876;117.542422,40.434266;117.542422,40.434266;117.54197,40.435716;117.541454,40.436979;117.541454,40.436979;117.541428,40.437044;117.541428,40.437044;117.541185,40.438364;117.541115,40.438585;117.541072,40.438694;117.540994,40.438767;117.540903,40.438819;117.540621,40.438928;117.540621,40.438928;117.539766,40.439223;117.53921,40.439518;117.53885,40.439813;117.538095,40.440642;117.53786,40.440937;117.537639,40.441172;117.537639,40.441172;117.537569,40.441246;117.537066,40.441636;117.537066,40.441636;117.536892,40.441771;117.536393,40.442096;117.535951,40.442331;117.535503,40.442535;117.532886,40.443455;117.531549,40.443867;117.53122,40.443989;117.531137,40.444063;117.531046,40.44418;117.530968,40.444366;117.530825,40.444926 此路段坐标点- walk_type String 0 这段路是否存在特殊的方式 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡- action String 右转 步行主要动作- assistant_action - instruction String 沿074乡道向西北步行10189米右转 路段步行指示- road String 074乡道 道路名称- assistant_action String[] 步行辅助动作- origin String 117.600244,40.417801- destination String 117.500244,40.417801info String ok 返回的状态信息 --status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "a48f015471de4c9287bc7020d501df91",
"showapi_res_body": {
"infocode": "10000",
"count": "1",
"status": "1",
"route": {
"paths": [
{
"duration": "11945",
"distance": "14931",
"steps": [
{
"orientation": "西北",
"duration": "8151",
"distance": "10189",
"polyline": "117.596884,40.41599;117.596892,40.415968;117.596888,40.41592;117.59678,40.415816;117.595608,40.415425;117.595156,40.415156;117.595026,40.414631;117.594905,40.414444;117.594796,40.414214;117.594852,40.41388;117.595013,40.413411;117.595243,40.41263;117.595412,40.412205;117.595543,40.411675;117.595859,40.41079;117.595829,40.410569;117.595339,40.409779;117.595104,40.409262;117.594957,40.408811;117.594822,40.408524;117.594601,40.408155;117.594128,40.407504;117.594071,40.407378;117.593958,40.406953;117.59385,40.406662;117.59385,40.406662;117.593828,40.406441;117.593798,40.40638;117.593707,40.406302;117.593585,40.40625;117.593333,40.406198;117.593082,40.406185;117.592839,40.406211;117.592487,40.406285;117.592487,40.406285;117.592287,40.406363;117.591914,40.406589;117.591623,40.406693;117.591172,40.406784;117.590135,40.407057;117.589939,40.407101;117.589679,40.407131;117.589379,40.407131;117.589158,40.407166;117.588685,40.407305;117.588112,40.407552;117.587457,40.407769;117.587344,40.407791;117.586892,40.407817;117.586758,40.407812;117.586246,40.40773;117.585842,40.407752;117.585664,40.407747;117.585252,40.407717;117.584588,40.407704;117.584366,40.407674;117.584206,40.407622;117.583672,40.407227;117.583477,40.407105;117.582765,40.406927;117.582561,40.406853;117.582148,40.406662;117.582148,40.406662;117.581697,40.406445;117.581215,40.406172;117.580994,40.406115;117.580773,40.406102;117.580651,40.406115;117.580538,40.406155;117.580417,40.406211;117.580339,40.406272;117.579944,40.406714;117.579371,40.407287;117.579271,40.407352;117.579158,40.407413;117.578876,40.407509;117.578537,40.407569;117.57803,40.407582;117.577739,40.407582;117.577296,40.407556;117.576923,40.407513;117.576671,40.407513;117.576198,40.407609;117.57592,40.407687;117.5748,40.407895;117.572513,40.408268;117.571506,40.408416;117.57072,40.408477;117.570169,40.408481;117.569874,40.408472;117.569592,40.408442;117.567912,40.408016;117.567057,40.407839;117.566727,40.407799;117.566424,40.407808;117.566302,40.407856;117.566233,40.407921;117.566189,40.408034;117.566133,40.408429;117.566072,40.408598;117.565842,40.408958;117.565629,40.409232;117.565447,40.409392;117.56474,40.409783;117.564631,40.409831;117.564449,40.409865;117.564258,40.409852;117.563767,40.409709;117.563433,40.409583;117.562656,40.409219;117.561237,40.408763;117.560707,40.408607;117.560512,40.408576;117.560295,40.408572;117.560295,40.408572;117.559978,40.408611;117.559757,40.408694;117.559666,40.408746;117.559549,40.408859;117.559436,40.408989;117.559345,40.409136;117.559288,40.409306;117.559275,40.409401;117.559266,40.409588;117.55928,40.409692;117.559314,40.409822;117.559379,40.409961;117.559462,40.410091;117.559714,40.410378;117.560117,40.410725;117.560742,40.411198;117.561011,40.411445;117.561124,40.411632;117.561367,40.412057;117.561619,40.412444;117.561667,40.412569;117.561654,40.412669;117.561632,40.412721;117.561549,40.412795;117.561428,40.412839;117.561306,40.412865;117.560937,40.412891;117.560395,40.412943;117.560013,40.412964;117.558724,40.41293;117.558628,40.412938;117.558542,40.413003;117.558481,40.413099;117.558442,40.413273;117.558446,40.413464;117.558477,40.413589;117.558568,40.413763;117.559089,40.41454;117.559622,40.41553;117.559696,40.415694;117.559722,40.415786;117.559722,40.415859;117.559696,40.415955;117.559596,40.416124;117.559466,40.416272;117.558945,40.416675;117.558763,40.416797;117.558572,40.416875;117.557856,40.417096;117.557613,40.417196;117.556832,40.417591;117.556285,40.417917;117.556285,40.417917;117.556107,40.417999;117.556107,40.417999;117.555981,40.418034;117.55559,40.418082;117.555412,40.418134;117.555169,40.418281;117.555056,40.418368;117.555017,40.418424;117.554948,40.418542;117.554878,40.418832;117.554787,40.419102;117.554774,40.419449;117.554722,40.419596;117.554501,40.419952;117.554423,40.42013;117.554353,40.42026;117.553967,40.420694;117.55385,40.42089;117.553676,40.421337;117.55365,40.421441;117.553615,40.422187;117.553624,40.422448;117.553685,40.423012;117.553694,40.423147;117.553676,40.42332;117.553568,40.423872;117.553568,40.423872;117.553485,40.424266;117.553485,40.424266;117.553416,40.424562;117.553416,40.424562;117.553333,40.424948;117.553333,40.424948;117.55299,40.426063;117.552921,40.426554;117.552938,40.427582;117.552938,40.427582;117.552891,40.427904;117.552843,40.428064;117.552769,40.42822;117.552582,40.428481;117.552582,40.428481;117.552387,40.428698;117.551966,40.429063;117.551697,40.42924;117.551163,40.429544;117.550981,40.429605;117.550768,40.429648;117.550499,40.429661;117.549488,40.429674;117.549045,40.429661;117.548572,40.429622;117.547578,40.429423;117.547036,40.429375;117.546641,40.429375;117.546185,40.429401;117.545794,40.429466;117.545503,40.429536;117.544922,40.42974;117.544666,40.429857;117.544453,40.429978;117.544453,40.429978;117.544297,40.430113;117.544145,40.430317;117.544032,40.430538;117.543915,40.430864;117.543915,40.430864;117.54385,40.431124;117.543793,40.431484;117.543793,40.431484;117.543672,40.432457;117.543633,40.432617;117.543581,40.432739;117.543407,40.432977;117.543207,40.433194;117.542886,40.433437;117.542812,40.43352;117.542812,40.43352;117.542756,40.433576;117.542574,40.433876;117.542422,40.434266;117.542422,40.434266;117.54197,40.435716;117.541454,40.436979;117.541454,40.436979;117.541428,40.437044;117.541428,40.437044;117.541185,40.438364;117.541115,40.438585;117.541072,40.438694;117.540994,40.438767;117.540903,40.438819;117.540621,40.438928;117.540621,40.438928;117.539766,40.439223;117.53921,40.439518;117.53885,40.439813;117.538095,40.440642;117.53786,40.440937;117.537639,40.441172;117.537639,40.441172;117.537569,40.441246;117.537066,40.441636;117.537066,40.441636;117.536892,40.441771;117.536393,40.442096;117.535951,40.442331;117.535503,40.442535;117.532886,40.443455;117.531549,40.443867;117.53122,40.443989;117.531137,40.444063;117.531046,40.44418;117.530968,40.444366;117.530825,40.444926",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "沿074乡道向西北步行10189米右转",
"road": "074乡道"
},
{
"orientation": "东南",
"duration": "88",
"distance": "110",
"polyline": "117.53082,40.444926;117.531719,40.444666;117.531849,40.444609;117.531997,40.44451",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "向东南步行110米右转",
"road": []
},
{
"orientation": "西南",
"duration": "562",
"distance": "702",
"polyline": "117.531997,40.444505;117.531337,40.443954;117.531007,40.443698;117.530621,40.44349;117.530369,40.443368;117.530369,40.443368;117.53,40.443234;117.529796,40.443173;117.529557,40.443121;117.529084,40.443051;117.52862,40.443038;117.527543,40.443103;117.527322,40.443103;117.527079,40.44309;117.526606,40.443021;117.526163,40.442891;117.52576,40.442708;117.525569,40.442595;117.525208,40.442339;117.525065,40.442196;117.524905,40.442005",
"walk_type": "0",
"action": [],
"assistant_action": [],
"instruction": "沿112国道向西南步行702米",
"road": "112国道"
},
{
"orientation": "西南",
"duration": "599",
"distance": "749",
"polyline": "117.5249,40.442001;117.523928,40.441059;117.523928,40.441059;117.523615,40.440751;117.523615,40.440751;117.523251,40.440321;117.522843,40.439657;117.522609,40.439345;117.521775,40.437821;117.521623,40.4375;117.521541,40.437231;117.521541,40.437231;117.521359,40.43658;117.521359,40.43658;117.52128,40.436372;117.521211,40.436276;117.521141,40.436202;117.520938,40.436055",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "向西南步行749米右转",
"road": []
},
{
"orientation": "西",
"duration": "246",
"distance": "307",
"polyline": "117.520933,40.43605;117.520321,40.436128;117.520321,40.436128;117.519266,40.436272;117.519266,40.436272;117.519197,40.436285;117.519197,40.436285;117.518937,40.436324;117.518937,40.436324;117.518429,40.436385;117.518429,40.436385;117.517826,40.436471;117.517826,40.436471;117.517335,40.436536",
"walk_type": "0",
"action": "左转",
"assistant_action": [],
"instruction": "沿站前路向西步行307米左转",
"road": "站前路"
},
{
"orientation": "南",
"duration": "1494",
"distance": "1868",
"polyline": "117.517331,40.436536;117.517253,40.436319;117.517253,40.436319;117.516888,40.435378;117.516888,40.435378;117.516207,40.433624;117.516207,40.433624;117.516046,40.433216;117.516046,40.433216;117.515664,40.43224;117.515664,40.43224;117.515421,40.431589;117.515421,40.431589;117.515161,40.430868;117.515161,40.430868;117.515056,40.430543;117.515056,40.430543;117.514905,40.430135;117.514905,40.430135;117.514436,40.428906;117.514436,40.428906;117.514392,40.42878;117.514392,40.42878;117.513789,40.427183;117.513789,40.427183;117.513637,40.426766;117.513637,40.426766;117.513073,40.425187;117.513073,40.425187;117.512826,40.424618;117.512826,40.424618;117.512409,40.424028;117.512409,40.424028;117.511927,40.423394;117.511927,40.423394;117.511654,40.423064;117.511654,40.423064;117.511033,40.42253;117.511033,40.42253;117.509996,40.421662;117.509735,40.421463;117.509735,40.421463;117.509644,40.42138;117.509523,40.421241;117.509462,40.421094;117.509453,40.420994",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "沿东区大街向南步行1868米右转",
"road": "东区大街"
},
{
"orientation": "西",
"duration": "530",
"distance": "662",
"polyline": "117.509449,40.42099;117.508585,40.420621;117.507791,40.420365;117.506519,40.420109;117.506519,40.420109;117.505946,40.420052;117.503733,40.419926;117.503099,40.4199;117.501888,40.419891",
"walk_type": "0",
"action": "左转",
"assistant_action": [],
"instruction": "沿北环路向西步行662米左转",
"road": "北环路"
},
{
"orientation": "南",
"duration": "113",
"distance": "141",
"polyline": "117.501884,40.419887;117.502096,40.419188;117.502096,40.419188;117.502179,40.418872;117.502179,40.418872;117.502248,40.418637",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "沿中兴路向南步行141米右转",
"road": "中兴路"
},
{
"orientation": "西",
"duration": "47",
"distance": "59",
"polyline": "117.502248,40.418633;117.502062,40.41862;117.502062,40.41862;117.501697,40.418568;117.501576,40.41852",
"walk_type": "0",
"action": "左转",
"assistant_action": [],
"instruction": "向西步行59米左转",
"road": []
},
{
"orientation": "南",
"duration": "26",
"distance": "33",
"polyline": "117.501571,40.418516;117.501558,40.418403;117.501558,40.41822",
"walk_type": "0",
"action": "右转",
"assistant_action": [],
"instruction": "向南步行33米右转",
"road": []
},
{
"orientation": "西",
"duration": "89",
"distance": "111",
"polyline": "117.501554,40.418216;117.500916,40.418125;117.500256,40.418064",
"walk_type": "0",
"action": [],
"assistant_action": "到达目的地",
"instruction": "向西步行111米到达目的地",
"road": []
}
]
}
],
"origin": "117.600244,40.417801",
"destination": "117.500244,40.417801"
},
"info": "ok"
}
}
接口地址:http://route.showapi.com/2127-6 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 keywords String 是 查询关键字 规则:只支持单个关键词语搜索关键词支持:行政区名称、citycode、adcode 例如,在subdistrict=2,搜索省份(例如山东),能够显示市(例如济南),区(例如历下区) adcode信息可参考城市编码表获取subdistrict String 否 规则:设置显示下级行政区级数(行政区级别包括:国家、省/直辖市、市、区/县、乡镇/街道多级数据) 可选值:0、1、2、3等数字,并以此类推 0:不返回下级行政区; 1:返回下一级行政区; 2:返回下两级行政区; 3:返回下三级行政区; 需要在此特殊说明,目前部分城市和省直辖县因为没有区县的概念,故在市级下方直接显示街道。 例如:广东-东莞、海南-文昌市page String 否 需要第几页数据 最外层的districts最多会返回20个数据,若超过限制,请用page请求下一页数据。offset String 否 最外层返回数据个数extensions String base 否 返回结果控制 此项控制行政区信息中返回行政区边界坐标点; 可选值:base、all; base:不返回行政区边界坐标点; all:只返回当前查询district的边界值,不返回子节点的边界值; 目前不能返回乡镇/街道级别的边界值filter String 否 按照指定行政区划进行过滤,填入后则只返回该省/直辖市信息 需填入adcode,为了保证数据的正确,强烈建议填入此参数...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-6","my_appId","my_appSecret") .addTextPara("keywords","") .addTextPara("subdistrict","") .addTextPara("page","") .addTextPara("offset","") .addTextPara("extensions","") .addTextPara("filter","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000 状态码,返回状态说明,10000代表正确,详情参阅info状态表count String 1status String 1 返回结果状态值, 值为0或1,0表示失败;1表示成功districts Object[] 行政区列表- 0 Object - center String 117.000923,36.675807 区域中心点- citycode - level String province 行政区划级别country:国家 province:省份(直辖市会在province和city显示) city:市(直辖市会在province和city显示) district:区县 street:街道- name String 山东省 行政区名称- districts Object[] 行政区列表- 0 Object - center String 115.980367,36.456013 区域中心点- citycode String 0635 城市编码- level String city 行政区划级别- name String 聊城市 行政区名称- districts Object[] 行政区列表- 0 Object - center String 115.444808,36.483753- citycode String 0635- level String district- name String 冠县- districts - adcode String 371525- citycode Object[] - adcode String[] 371500 区域编码 街道没有独有的adcode,均继承父类(区县)的adcode- citycode String[] 城市编码suggestion Object 建议结果列表- keywords - cities - keywords String[] 建议关键字列表- cites String[] 建议城市列表info String OK...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "28e04e171d1e4164bcf4f03a5f181123",
"showapi_res_body": {
"infocode": "10000",
"count": "1",
"status": "1",
"districts": [
{
"center": "117.000923,36.675807",
"citycode": [],
"level": "province",
"name": "山东省",
"districts": [
{
"center": "115.980367,36.456013",
"citycode": "0635",
"level": "city",
"name": "聊城市",
"districts": [
{
"center": "115.444808,36.483753",
"citycode": "0635",
"level": "district",
"name": "冠县",
"districts": [],
"adcode": "371525"
},
{
"center": "116.248855,36.336004",
"citycode": "0635",
"level": "district",
"name": "东阿县",
"districts": [],
"adcode": "371524"
},
{
"center": "116.229662,36.859755",
"citycode": "0635",
"level": "district",
"name": "高唐县",
"districts": [],
"adcode": "371526"
},
{
"center": "115.667291,36.237597",
"citycode": "0635",
"level": "district",
"name": "莘县",
"districts": [],
"adcode": "371522"
},
{
"center": "115.784287,36.113708",
"citycode": "0635",
"level": "district",
"name": "阳谷县",
"districts": [],
"adcode": "371521"
},
{
"center": "116.25335,36.591934",
"citycode": "0635",
"level": "district",
"name": "茌平区",
"districts": [],
"adcode": "371523"
},
{
"center": "115.980023,36.45606",
"citycode": "0635",
"level": "district",
"name": "东昌府区",
"districts": [],
"adcode": "371502"
},
{
"center": "115.713462,36.842598",
"citycode": "0635",
"level": "district",
"name": "临清市",
"districts": [],
"adcode": "371581"
}
],
"adcode": "371500"
}
]
}],
"suggestion": {
"keywords": [],
"cities": []
},
"info": "OK"
}
}
接口地址:http://route.showapi.com/2127-7 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 keywords String 否 查询关键字 规则: 多个关键字用“|”分割 若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。types String 否 查询POI类型 可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。 若指定了某个大类,则所属的中类、小类都会被显示。 例如:010000为汽车服务(大类) 010100为加油站(中类) 010101为中国石化(小类) 010900为汽车租赁(中类) 010901为汽车租赁还车(小类) 当指定010000,则010100等中类、010101等小类都会被包含,当指定010900,则010901等小类都会被包含。 参考 POI分类编码和城市编码表 若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)city String 否 查询城市 可选值:城市中文、中文全拼、citycode、adcode 如:北京/beijing/010/110000 填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。 如:在深圳市搜天安门,返回北京天安门结果。citylimit String false 否 仅返回指定城市数据,可选值:true/falsechildren String 否 是否按照层级展示子POI数据 可选值:children=1 当为0的时候,子POI都会显示。 当为1的时候,子POI会归类到父POI之中。 仅在extensions=all的时候生效offset String 否 每页记录数据 强烈建议不超过25,若超过25可能造成访问报错page String 否 当前页数 最大翻页数100extensions String base 否 返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-7","my_appId","my_appSecret") .addTextPara("keywords","") .addTextPara("types","") .addTextPara("city","") .addTextPara("citylimit","") .addTextPara("children","") .addTextPara("offset","") .addTextPara("page","") .addTextPara("extensions","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000count String 899 搜索方案数目(最大值为1000)status String 1 结果状态值 -- 0:请求失败;1:请求成功pois Object[] 搜索POI信息列表- 0 Object - biz_type String diner 行业类型- typecode String 050117 兴趣点类型编码- location String 116.297275,39.865844 经纬度- poiweight - tel String 010-83897276;010-83897277 POI的电话- parent - type String 餐饮服务;中餐厅;火锅店 兴趣点类型- photos Object[] 照片相关信息- 0 Object - title - provider - url String http://store.is.autonavi.com/showpic/e016826133059e3d2bda52fe1cd8394d 具体链接- title String 图片介绍- id String B000A9JJB5 唯一ID- shopinfo String 1- shopid - distance - importance - address String 丰台北路36号华铁大厦C座1-2层 地址- name String 海底捞火锅(万丰桥店) 名称- biz_ext Object 深度信息- meal_ordering String 0 是否可订餐- rating String 5.0 评分- cost String 128.00 人均消费- pname String 北京市 POI所在省份名称--若是直辖市的时候,此处直接显示市名,例如北京市- cityname String 北京市 城市名--若是直辖市的时候,此处直接显示市名,例如北京市- childtype - adname String 丰台区 区域名称- parent String 父POI的ID -- 当前POI如果有父POI,则返回父POI的ID。可能为空suggestion Object 城市建议列表--当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表;- keywords - cities - keywords String[] 关键字- cities Object[] 城市列表- name String 名称- num String 该城市包含此关键字的个数- citycode String 该城市的citycode- adcode String 该城市的adcodeinfo String OK...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "b946b768edf64f009beec399862afef6",
"showapi_res_body": {
"infocode": "10000",
"count": "899",
"status": "1",
"pois": [
{
"biz_type": "diner",
"typecode": "050117",
"location": "116.297275,39.865844",
"poiweight": [],
"tel": "010-83897276;010-83897277",
"parent": [],
"type": "餐饮服务;中餐厅;火锅店",
"photos": [
{
"title": [],
"provider": [],
"url": "http://store.is.autonavi.com/showpic/e016826133059e3d2bda52fe1cd8394d"
},
{
"title": [],
"provider": [],
"url": "http://store.is.autonavi.com/showpic/4c773fb79c7c531946c7ca66d177ded4"
},
{
"title": [],
"provider": [],
"url": "http://store.is.autonavi.com/showpic/8bf6b0af1506410994810681a605fd8b"
}
],
"id": "B000A9JJB5",
"shopinfo": "1",
"shopid": [],
"distance": [],
"importance": [],
"address": "丰台北路36号华铁大厦C座1-2层",
"name": "海底捞火锅(万丰桥店)",
"biz_ext": {
"meal_ordering": "0",
"rating": "5.0",
"cost": "128.00"
},
"pname": "北京市",
"cityname": "北京市",
"childtype": [],
"adname": "丰台区"
}
],
"suggestion": {
"keywords": [],
"cities": []
},
"info": "OK"
}
}
接口地址:http://route.showapi.com/2127-9 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 locations String 是 坐标点--经度和纬度用","分割,经度在前,纬度在后,经纬度小数点后不得超过6位。多个坐标对之间用”|”进行分隔最多支持40对坐标。coordsys String autonavi 否 coordsys 原坐标系 可选值: gps; mapbar; baidu; autonavi(不进行转换)
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-9","my_appId","my_appSecret") .addTextPara("locations","") .addTextPara("coordsys","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000locations String 116.481499,39.990475|116.481499,39.990375 转换之后的坐标。若有多个坐标,则用 “;”进行区分和间隔status String 1 返回状态1:成功;0:失败info String ok...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "36bbd1c7cfde40f0a2caa3f7a8e48478",
"showapi_res_body": {
"infocode": "10000",
"locations": "116.481499,39.990475|116.481499,39.990375",
"status": "1",
"info": "ok"
}
}
接口地址:http://route.showapi.com/2127-10 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 keywords String 是 查询关键词type String 否 POI分类 服务可支持传入多个分类,多个类型剑用“|”分隔 可选值:POI分类名称、分类代码 此处强烈建议使用分类代码,否则可能会得到不符合预期的结果location String 否 坐标--格式:“X,Y”(经度,纬度),不可以包含空格 建议使用location参数,可在此location附近优先返回搜索关键词信息city String 否 搜索城市 可选值:citycode、adcode,不支持县级市。 如:010/110000 adcode信息可参考城市编码表获取。 填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。 如:在深圳市搜天安门,返回北京天安门结果。citylimit String 否 仅返回指定城市数据 -- 可选值:true/falsedatatype String 否 返回的数据类型 -- 多种数据类型用“|”分隔,可选值:all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-10","my_appId","my_appSecret") .addTextPara("keywords","") .addTextPara("type","") .addTextPara("location","") .addTextPara("city","") .addTextPara("citylimit","") .addTextPara("datatype","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000count String 10 返回结果总数目status String 1 1:成功;0:失败tips Object[] 建议提示列表- 0 Object - id String B000A8UIN8 返回数据ID 若数据为POI类型,则返回POI ID;若数据为bus类型,则返回bus id;若数据为busline类型,则返回busline id。- typecode String 110201|140100- address String 景山前街4号 详细地址- location String 116.397036,39.917834 tip中心点坐标- name String 故宫博物院 tip名称- adcode String 110101 六位区县编码- district String 北京市东城区 省+市+区(直辖市为“市+区”)- city info String OK...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "091ce45f70a340c4871ca9ec95e7dd7d",
"showapi_res_body": {
"infocode": "10000",
"count": "10",
"status": "1",
"tips": [
{
"id": "B000A8UIN8",
"typecode": "110201|140100",
"address": "景山前街4号",
"location": "116.397036,39.917834",
"name": "故宫博物院",
"adcode": "110101",
"district": "北京市东城区",
"city": []
}{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "091ce45f70a340c4871ca9ec95e7dd7d",
"showapi_res_body": {
"infocode": "10000",
"count": "10",
"status": "1",
"tips": [
{
"id": "B000A8UIN8",
"typecode": "110201|140100",
"address": "景山前街4号",
"location": "116.397036,39.917834",
"name": "故宫博物院",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B000A84AS4",
"typecode": "991401",
"address": "景山前街4号故宫博物院",
"location": "116.397276,39.912905",
"name": "故宫博物院(南门)",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "BV10000074",
"typecode": "150700",
"address": "101路;103路;109路;124路;128路;58路;夜13路;观光1线;观光2线;观光3线",
"location": "116.395760,39.923279",
"name": "故宫(公交站)",
"adcode": "110102",
"district": "北京市西城区",
"city": []
},
{
"id": "B000A84GDN",
"typecode": "110200",
"address": "景山前街4号故宫博物院内",
"location": "116.397330,39.913905",
"name": "故宫博物院-午门",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B000A60DA1",
"typecode": "110201|110202",
"address": "东长安街",
"location": "116.397451,39.909187",
"name": "天安门",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B000A81IQA",
"typecode": "991400",
"address": "景山前街4号故宫博物院",
"location": "116.396909,39.923065",
"name": "故宫博物院(北门)",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B000A81GPU",
"typecode": "991400",
"address": "景山前街4号故宫博物院",
"location": "116.401427,39.915136",
"name": "故宫博物院(东华门)",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B000A9PISW",
"typecode": "110200",
"address": "景山前街4号北京故宫博物馆",
"location": "116.396942,39.922333",
"name": "故宫博物院-神武门",
"adcode": "110101",
"district": "北京市东城区",
"city": []
},
{
"id": "B0FFG7HHUH",
"typecode": "150905",
"address": "北长街与南长街交叉口东50米",
"location": "116.391910,39.914951",
"name": "故宫博物院-停车场(西华门西)(暂停营业)",
"adcode": "110102",
"district": "北京市西城区",
"city": []
},
{
"id": "B000A9JTP4",
"typecode": "991401",
"address": "景山前街4号故宫博物院内",
"location": "116.39272,39.914836",
"name": "故宫博物院(西华门)",
"adcode": "110101",
"district": "北京市东城区",
"city": []
}
],
"info": "OK"
}
}
],
"info": "OK"
}
}
接口地址:http://route.showapi.com/2127-12 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 location String 116.480881,39.989410是 经纬度坐标 : 传入内容规则:经度在前,纬度在后,经纬度间以“,”分割,经纬度小数点后不要超过 6 位。如果需要解析多个经纬度的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持传入 20 对坐标点。每对点坐标之间用"|"分割。poitype String 否 返回附近POI类型 . 需要 extensions 参数为 all 时才生效。逆地理编码在进行坐标解析之后不仅可以返回地址描述,也可以返回经纬度附近符合限定要求的POI内容(在 extensions 字段值为 all 时才会返回POI内容)。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE,可以传入多个POI TYPECODE,相互之间用“|”分隔。该参数在 batch 取值为 true 时不生效。获取 POI TYPECODE 可以参考POI分类码表radius String 1000 否 搜索半径 - radius取值范围在0~3000,默认是1000。单位:米extensions String base 否 返回结果控制 --- extensions 参数默认取值是 base,也就是返回基本地址信息; extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。batch String 否 批量查询控制 -- batch 参数设置为 true 时进行批量查询操作,最多支持 20 个经纬度点进行批量地址查询操作。roadlevel String 否 道路等级 --需要 extensions 参数为 all 时才生效。 可选值:0,1 当roadlevel=0时,显示所有道路 当roadlevel=1时,过滤非主干道路,仅输出主干道路数据homeorcorp String 否 homeorcorp--是否优化POI返回顺序 , 需要 extensions 参数为 all 时才生效。 homeorcorp 参数的设置可以影响召回 POI 内容的排序策略,目前提供三个可选参数: 0:不对召回的排序策略进行干扰。 1:综合大数据分析将居家相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。 2:综合大数据分析将公司相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-12","my_appId","my_appSecret") .addTextPara("location","116.480881,39.989410") .addTextPara("poitype","") .addTextPara("radius","") .addTextPara("extensions","") .addTextPara("batch","") .addTextPara("roadlevel","") .addTextPara("homeorcorp","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 infocode String 10000status String 1 返回结果状态值--返回值为 0 或 1,0 表示请求失败;1 表示请求成功。regeocode Object 逆地理编码列表 batch 字段设置为 true 时为批量请求,此时 regeocodes 标签返回,标签下为 regeocode 对象列表; batch 为false 时为单个请求,会返回 regeocode 对象;regeocode 对象包含的数据如下:- addressComponent Object 地址元素列表- citycode String 010 城市编码--例如:010- building Object 楼信息列表- name String 方恒国际中心A座 建筑名称- type String 商务住宅;楼宇;商务写字楼 类型- township String 望京街道 township--坐标点所在乡镇/街道(此街道为社区街道,不是道路信息)- towncode String 110105026000 乡镇街道编码- neighborhood Object 社区信息列表- name String 方恒国际中心 社区名称- type String 商务住宅;楼宇;商住两用楼宇 POI类型- province String 北京市 坐标点所在省名称- adcode String 110105 行政区编码- businessAreas Object[] 经纬度所属商圈列表- 0 Object - id String 110105 商圈所在区域的adcode- location String 116.470293,39.996171 商圈中心点经纬度- name String 望京 商圈名称- streetNumber Object 门牌信息列表- distance String 104.661 门牌地址到请求坐标的距离- location String 116.480162,39.9886469 坐标点- direction String 西南 方向- street String 阜通东大街 街道名称- number String 8号 门牌号- district String 朝阳区 坐标点所在区- country String 中国 国家- city - formatted_address String 北京市朝阳区望京街道方恒国际中心A座北京方恒假日酒店 结构化地址信息info String OK 当 status 为 0 时,info 会返回具体错误原因,否则返回“OK”。详情可以参考info状态表...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "03e6ad430b0d444bac96278b13b986ba",
"showapi_res_body": {
"infocode": "10000",
"status": "1",
"regeocode": {
"addressComponent": {
"citycode": "010",
"building": {
"name": "方恒国际中心A座",
"type": "商务住宅;楼宇;商务写字楼"
},
"township": "望京街道",
"towncode": "110105026000",
"neighborhood": {
"name": "方恒国际中心",
"type": "商务住宅;楼宇;商住两用楼宇"
},
"province": "北京市",
"adcode": "110105",
"businessAreas": [
{
"id": "110105",
"location": "116.470293,39.996171",
"name": "望京"
},
{
"id": "110105",
"location": "116.494356,39.971563",
"name": "酒仙桥"
},
{
"id": "110105",
"location": "116.492891,39.981321",
"name": "大山子"
}
],
"streetNumber": {
"distance": "104.661",
"location": "116.480162,39.9886469",
"direction": "西南",
"street": "阜通东大街",
"number": "8号"
},
"district": "朝阳区",
"country": "中国",
"city": []
},
"formatted_address": "北京市朝阳区望京街道方恒国际中心A座北京方恒假日酒店"
},
"info": "OK"
}
}
接口地址:http://route.showapi.com/2127-13 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 labels String 朝阳公园,2,0,16,0xFFFFFF,0x008000:116.48482,39.94858是 标签。使用规则见labels详细说明(http://lbs.amap.com/api/webservice/guide/api/staticmaps),标签最大数10个location String 116.481485,39.990464是 地图中心点坐标。规则:经度和纬度用","分隔 经纬度小数点后不得超过6位。markers String mid,0xFF0000,A:116.481485,39.990464否 标注。使用规则见markers详细说明(http://lbs.amap.com/api/webservice/guide/api/staticmaps),标注最大数50个paths String 10,0x0000ff,1,,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957否 折线。使用规则见paths详细说明(http://lbs.amap.com/api/webservice/guide/api/staticmaps),折线和多边形最大数4个scale String 1否 1:返回普通图; 2:调用高清图,图片高度和宽度都增加一倍,zoom也增加一倍(当zoom为最大值时,zoom不再改变)。size String 750*300否 图片宽度*图片高度。最大值为1024*1024traffic String 0否 交通路况标识。底图是否展现实时路况。 可选值: 0,不展现;1,展现。zoom String 10否 地图缩放级别:[1,17]...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-13","my_appId","my_appSecret") .addTextPara("labels","朝阳公园,2,0,16,0xFFFFFF,0x008000:116.48482,39.94858") .addTextPara("location","116.481485,39.990464") .addTextPara("markers","mid,0xFF0000,A:116.481485,39.990464") .addTextPara("paths","10,0x0000ff,1,,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957") .addTextPara("scale","1") .addTextPara("size","750*300") .addTextPara("traffic","0") .addTextPara("zoom","10") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 img_base64 String 图片base64编码 图片base64编码...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "2bc893ccdc144c68830b51aa570480cc",
"showapi_res_code": 0,
"showapi_res_body": {
"img_base64": "图片base64编码" }
}
接口地址:http://route.showapi.com/2127-14 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 city String 昆明是 城市/跨城规划时的起点城市 目前支持市内公交换乘/跨城公交的起点城市。 可选值:城市名称/citycodecityd String 否 跨城公交规划时的终点城市 跨城公交规划必填参数。 可选值:城市名称/citycodedate String 否 出发日期 根据出发时间和日期筛选可乘坐的公交路线,格式:date=2014-3-19destination String 102.7221,25.0149是 目的地 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位origin String 102.8622,24.8658是 出发点。规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位strategy String 否 公交换乘策略 可选值: 0:最快捷模式 1:最经济模式 2:最少换乘模式 3:最少步行模式 5:不乘地铁模式time String 否 出发时间 根据出发时间和日期筛选可乘坐的公交路线,格式:time=22:34...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-14","my_appId","my_appSecret") .addTextPara("city","昆明") .addTextPara("cityd","") .addTextPara("date","") .addTextPara("destination","102.7221,25.0149") .addTextPara("origin","102.8622,24.8658") .addTextPara("strategy","") .addTextPara("time","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1 返回状态 值为0或1 1:成功;0:失败info String OK status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表infocode String 10000 详情参阅info状态表count String 3 公交换乘方案数目route Object 公交换乘信息列表- origin String 116.481028,39.989643 起点坐标- destination String 116.434446,39.90816 终点坐标- distance String 14248 起点和终点的步行距离 单位:米- taxi_cost String 38.8704 出租车费用 单位:元- transits Object[] 公交换乘方案列表- 0 Object 公交换乘方案- cost String 3.0 此换乘方案价格 单位:元- duration String 3562 此换乘方案预期时间 单位:秒- nightflag String 0 是否是夜班车 0:非夜班车;1:夜班车- walking_distance String 1281 此方案总步行距离 单位:米- distance String 13759 每段线路步行距离- missed String 0- segments Object[] 换乘路段列表- 0 Object - taxi String[] []- walking Object 此路段步行导航信息- origin String 116.481003,39.989311 起点坐标- destination String 116.481987,39.983784 终点坐标- distance String 852 每段线路步行距离- duration String 730 步行预计时间- steps Object[] 步行路段列表- 0 Object - instruction String 步行13米左转 此段路的行走介绍- road String[] [] 路的名字- distance String 13 此段路的距离- duration String[] [] 此段路预计消耗时间- polyline String 116.481003,39.989311;116.480957,39.989269;116.480904,39.989220 此段路的坐标- action String 左转 步行主要动作- assistant_action String[] [] 步行辅助动作- bus Object 此路段公交导航信息- buslines Object[] 步行路段列表- 0 Object - departure_stop Object 此段起乘站信息- name String 西八间房 站点名字- id String 110100013750005 站点id- location String 116.481979,39.983788 站点经纬度- arrival_stop Object 此段下车站 格式如:中关村- name String 北京站东 站点名字- id String 110100013750022 站点id- location String 116.434982,39.905178 站点经纬度- name String 403路(环行铁道--北京站东) 公交路线名称- id String 110100013750 公交路线id- type String 普通公交线路 公交类型- distance String 12478 公交行驶距离- duration String 2464 公交预计行驶时间- polyline String 116.481979,39.983788;116.481979,39.983784;116.481232,39.983082;116.480728,39.982639;116.479652,39.981663;116.478661,39.980789;116.478088,39.980267;116.478020,39.980198;116.477974,39.980160;116.477692,39.979881;116.477203,39.979431;116.476852,39.979111;116.476715,39.978992;116.476250,39.978569;116.476044,39.978386;116.475029,39.977474;116.474304,39.976814;116.473869,39.976425;116.473488,39.976070;116.473488,39.976067;116.473282,39.975887;116.472763,39.975426;116.472382,39.975113;116.471313,39.974144;116.469719,39.972679;116.469078,39.972118;116.468285,39.971397;116.466522,39.969795;116.465218,39.968616;116.464951,39.968369;116.463608,39.967155;116.463608,39.967152;116.462814,39.966431;116.462753,39.966377;116.461693,39.965412;116.460800,39.964592;116.460396,39.964237;116.460396,39.964233;116.460121,39.963974;116.459991,39.963860;116.459412,39.963337;116.458458,39.962479;116.458084,39.962132;116.457916,39.961983;116.457359,39.961472;116.457306,39.961422;116.456886,39.961063;116.456650,39.960876;116.456039,39.960464;116.455711,39.960289;116.455536,39.960209;116.454758,39.959835;116.454430,39.959644;116.454178,39.959438;116.452232,39.957672;116.452011,39.957626;116.451942,39.957619;116.451820,39.957630;116.451752,39.957661;116.451714,39.957699;116.451683,39.957748;116.451683,39.957787;116.451683,39.957817;116.451698,39.957859;116.451996,39.958145;116.452545,39.958633;116.452637,39.958664;116.452705,39.958668;116.452988,39.958641;116.453476,39.958328;116.454079,39.957935;116.454910,39.957390;116.455292,39.957123;116.455574,39.956852;116.455711,39.956722;116.455956,39.956532;116.456146,39.956383;116.456627,39.956043;116.457222,39.955643;116.457916,39.955193;116.458107,39.955059;116.458160,39.955017;116.458717,39.954659;116.459427,39.954201;116.459229,39.954124;116.459129,39.954067;116.459045,39.954010;116.458923,39.953888;116.458504,39.953533;116.458076,39.953144;116.457893,39.952972;116.457634,39.952744;116.457436,39.952560;116.457275,39.952423;116.456879,39.952053;116.456177,39.951424;116.455605,39.950909;116.455521,39.950829;116.455482,39.950760;116.455444,39.950680;116.455429,39.950474;116.455429,39.950325;116.455429,39.950096;116.455437,39.949604;116.455437,39.949440;116.455437,39.949436;116.455444,39.949112;116.455452,39.948429;116.454216,39.948242;116.453941,39.948204;116.452232,39.947952;116.451874,39.947895;116.451302,39.947800;116.450310,39.947651;116.450188,39.947552;116.450264,39.947430;116.450294,39.947323;116.450348,39.947128;116.450363,39.946930;116.450378,39.946678;116.450378,39.946453;116.450378,39.945892;116.450363,39.945690;116.450363,39.944378;116.450363,39.944096;116.450363,39.944092;116.450363,39.942520;116.450348,39.941284;116.450348,39.941185;116.450363,39.940342;116.450363,39.940159;116.450363,39.940155;116.450378,39.939892;116.450394,39.939823;116.450417,39.939243;116.450401,39.938435;116.450409,39.937840;116.450409,39.937050;116.450394,39.936646;116.450394,39.936588;116.450378,39.936207;116.450378,39.935547;116.450363,39.934643;116.450317,39.933769;116.450310,39.933613;116.450310,39.933025;116.450294,39.932671;116.450294,39.931282;116.450294,39.930984;116.450294,39.930698;116.450294,39.929718;116.450294,39.927937;116.450294,39.927547;116.450294,39.927544;116.450287,39.926975;116.450287,39.924904;116.450287,39.924351;116.450287,39.924202;116.450287,39.923122;116.450287,39.922943;116.450279,39.922825;116.450279,39.921940;116.450279,39.920994;116.450294,39.920437;116.450294,39.918690;116.450294,39.918415;116.450294,39.918411;116.450294,39.917961;116.450287,39.917740;116.450287,39.916817;116.450287,39.916740;116.450287,39.916435;116.450287,39.916050;116.450287,39.915661;116.450279,39.915215;116.450287,39.914852;116.450279,39.914471;116.450279,39.914150;116.450279,39.913399;116.450272,39.912483;116.450264,39.912354;116.450264,39.911530;116.450264,39.911026;116.450264,39.910484;116.450264,39.910309;116.450264,39.910294;116.450264,39.909588;116.450119,39.909588;116.450104,39.909401;116.450119,39.908886;116.450241,39.908669;116.450241,39.908539;116.449585,39.908546;116.447639,39.908546;116.447571,39.908546;116.446960,39.908554;116.445969,39.908550;116.444725,39.908562;116.444534,39.908569;116.443886,39.908581;116.443802,39.908581;116.442879,39.908581;116.441017,39.908588;116.440971,39.908588;116.439529,39.908604;116.438576,39.908611;116.436699,39.908607;116.436073,39.908611;116.435730,39.908619;116.435402,39.908630;116.435341,39.908665;116.435310,39.908695;116.435272,39.908714;116.435219,39.908768;116.435173,39.908825;116.435158,39.908924;116.435158,39.909172;116.435143,39.909443;116.435143,39.909710;116.435150,39.909798;116.435165,39.909870;116.435211,39.909935;116.435280,39.909966;116.435349,39.909977;116.435432,39.909969;116.435532,39.909916;116.435646,39.909752;116.435730,39.907696;116.435745,39.907406;116.435799,39.906498;116.435837,39.906208;116.435837,39.906105;116.435844,39.905937;116.435867,39.905743;116.435867,39.905689;116.435905,39.905548;116.435867,39.905437;116.435844,39.905376;116.435799,39.905327;116.435745,39.905285;116.435692,39.905251;116.435608,39.905220;116.435486,39.905197;116.435394,39.905182;116.434982,39.905178 此路段坐标集- start_time String 0505 首班车时间- end_time String 2305 末班车时间- via_num String 17 此段途经公交站数- via_stops Object[] 此段途经公交站点列表- 0 Object - name String 京顺路丽都饭店 途径公交站点信息- id String 110100013750006 公交站点编号- location String 116.476250,39.978569 公交站点经纬度- entrance String[] [] 地铁入口 只在地铁路段有值- exit String[] [] exit 地铁出口 只在地铁路段有值- railway Object 乘坐火车的信息 详情见只在地铁路段有值- spaces String[] [] 仓位及价格信息...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "0be6aeb5487544a6aada69de877bc650",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"info": "OK",
"infocode": "10000",
"count": "3",
"route": {
"origin": "116.481028,39.989643",
"destination": "116.434446,39.90816",
"distance": "14248",
"taxi_cost": "38.8704",
"transits": [
{
"cost": "3.0",
"duration": "3562",
"nightflag": "0",
"walking_distance": "1281",
"distance": "13759",
"missed": "0",
"segments": [
{
"taxi": [],
"walking": {
"origin": "116.481003,39.989311",
"destination": "116.481987,39.983784",
"distance": "852",
"duration": "730",
"steps": [
{
"instruction": "步行13米左转",
"road": [],
"distance": "13",
"duration": [],
"polyline": "116.481003,39.989311;116.480957,39.989269;116.480904,39.989220",
"action": "左转",
"assistant_action": []
},
{
"instruction": "沿阜荣街步行300米右转",
"road": "阜荣街",
"distance": "300",
"duration": [],
"polyline": "116.480904,39.989216;116.481430,39.988880;116.481468,39.988857;116.483414,39.987583;116.483467,39.987404",
"action": "右转",
"assistant_action": []
},
{
"instruction": "沿望京东路步行309米左转",
"road": "望京东路",
"distance": "309",
"duration": [],
"polyline": "116.483467,39.987400;116.483421,39.987358;116.482025,39.986088;116.481346,39.985485;116.481293,39.985435;116.481148,39.985275",
"action": "左转",
"assistant_action": []
},
{
"instruction": "沿广顺南大街步行162米右转",
"road": "广顺南大街",
"distance": "162",
"duration": [],
"polyline": "116.481148,39.985268;116.481247,39.985203;116.481270,39.985092;116.482162,39.984493;116.482498,39.984257",
"action": "右转",
"assistant_action": []
},
{
"instruction": "沿京密路步行68米到达西八间房",
"road": "京密路",
"distance": "68",
"duration": [],
"polyline": "116.482498,39.984253;116.481987,39.983784",
"action": [],
"assistant_action": "到达西八间房"
}
]
},
"bus": {
"buslines": [
{
"departure_stop": {
"name": "西八间房",
"id": "110100013750005",
"location": "116.481979,39.983788"
},
"arrival_stop": {
"name": "北京站东",
"id": "110100013750022",
"location": "116.434982,39.905178"
},
"name": "403路(环行铁道--北京站东)",
"id": "110100013750",
"type": "普通公交线路",
"distance": "12478",
"duration": "2464",
"polyline": "116.481979,39.983788;116.481979,39.983784;116.481232,39.983082;116.480728,39.982639;116.479652,39.981663;116.478661,39.980789;116.478088,39.980267;116.478020,39.980198;116.477974,39.980160;116.477692,39.979881;116.477203,39.979431;116.476852,39.979111;116.476715,39.978992;116.476250,39.978569;116.476044,39.978386;116.475029,39.977474;116.474304,39.976814;116.473869,39.976425;116.473488,39.976070;116.473488,39.976067;116.473282,39.975887;116.472763,39.975426;116.472382,39.975113;116.471313,39.974144;116.469719,39.972679;116.469078,39.972118;116.468285,39.971397;116.466522,39.969795;116.465218,39.968616;116.464951,39.968369;116.463608,39.967155;116.463608,39.967152;116.462814,39.966431;116.462753,39.966377;116.461693,39.965412;116.460800,39.964592;116.460396,39.964237;116.460396,39.964233;116.460121,39.963974;116.459991,39.963860;116.459412,39.963337;116.458458,39.962479;116.458084,39.962132;116.457916,39.961983;116.457359,39.961472;116.457306,39.961422;116.456886,39.961063;116.456650,39.960876;116.456039,39.960464;116.455711,39.960289;116.455536,39.960209;116.454758,39.959835;116.454430,39.959644;116.454178,39.959438;116.452232,39.957672;116.452011,39.957626;116.451942,39.957619;116.451820,39.957630;116.451752,39.957661;116.451714,39.957699;116.451683,39.957748;116.451683,39.957787;116.451683,39.957817;116.451698,39.957859;116.451996,39.958145;116.452545,39.958633;116.452637,39.958664;116.452705,39.958668;116.452988,39.958641;116.453476,39.958328;116.454079,39.957935;116.454910,39.957390;116.455292,39.957123;116.455574,39.956852;116.455711,39.956722;116.455956,39.956532;116.456146,39.956383;116.456627,39.956043;116.457222,39.955643;116.457916,39.955193;116.458107,39.955059;116.458160,39.955017;116.458717,39.954659;116.459427,39.954201;116.459229,39.954124;116.459129,39.954067;116.459045,39.954010;116.458923,39.953888;116.458504,39.953533;116.458076,39.953144;116.457893,39.952972;116.457634,39.952744;116.457436,39.952560;116.457275,39.952423;116.456879,39.952053;116.456177,39.951424;116.455605,39.950909;116.455521,39.950829;116.455482,39.950760;116.455444,39.950680;116.455429,39.950474;116.455429,39.950325;116.455429,39.950096;116.455437,39.949604;116.455437,39.949440;116.455437,39.949436;116.455444,39.949112;116.455452,39.948429;116.454216,39.948242;116.453941,39.948204;116.452232,39.947952;116.451874,39.947895;116.451302,39.947800;116.450310,39.947651;116.450188,39.947552;116.450264,39.947430;116.450294,39.947323;116.450348,39.947128;116.450363,39.946930;116.450378,39.946678;116.450378,39.946453;116.450378,39.945892;116.450363,39.945690;116.450363,39.944378;116.450363,39.944096;116.450363,39.944092;116.450363,39.942520;116.450348,39.941284;116.450348,39.941185;116.450363,39.940342;116.450363,39.940159;116.450363,39.940155;116.450378,39.939892;116.450394,39.939823;116.450417,39.939243;116.450401,39.938435;116.450409,39.937840;116.450409,39.937050;116.450394,39.936646;116.450394,39.936588;116.450378,39.936207;116.450378,39.935547;116.450363,39.934643;116.450317,39.933769;116.450310,39.933613;116.450310,39.933025;116.450294,39.932671;116.450294,39.931282;116.450294,39.930984;116.450294,39.930698;116.450294,39.929718;116.450294,39.927937;116.450294,39.927547;116.450294,39.927544;116.450287,39.926975;116.450287,39.924904;116.450287,39.924351;116.450287,39.924202;116.450287,39.923122;116.450287,39.922943;116.450279,39.922825;116.450279,39.921940;116.450279,39.920994;116.450294,39.920437;116.450294,39.918690;116.450294,39.918415;116.450294,39.918411;116.450294,39.917961;116.450287,39.917740;116.450287,39.916817;116.450287,39.916740;116.450287,39.916435;116.450287,39.916050;116.450287,39.915661;116.450279,39.915215;116.450287,39.914852;116.450279,39.914471;116.450279,39.914150;116.450279,39.913399;116.450272,39.912483;116.450264,39.912354;116.450264,39.911530;116.450264,39.911026;116.450264,39.910484;116.450264,39.910309;116.450264,39.910294;116.450264,39.909588;116.450119,39.909588;116.450104,39.909401;116.450119,39.908886;116.450241,39.908669;116.450241,39.908539;116.449585,39.908546;116.447639,39.908546;116.447571,39.908546;116.446960,39.908554;116.445969,39.908550;116.444725,39.908562;116.444534,39.908569;116.443886,39.908581;116.443802,39.908581;116.442879,39.908581;116.441017,39.908588;116.440971,39.908588;116.439529,39.908604;116.438576,39.908611;116.436699,39.908607;116.436073,39.908611;116.435730,39.908619;116.435402,39.908630;116.435341,39.908665;116.435310,39.908695;116.435272,39.908714;116.435219,39.908768;116.435173,39.908825;116.435158,39.908924;116.435158,39.909172;116.435143,39.909443;116.435143,39.909710;116.435150,39.909798;116.435165,39.909870;116.435211,39.909935;116.435280,39.909966;116.435349,39.909977;116.435432,39.909969;116.435532,39.909916;116.435646,39.909752;116.435730,39.907696;116.435745,39.907406;116.435799,39.906498;116.435837,39.906208;116.435837,39.906105;116.435844,39.905937;116.435867,39.905743;116.435867,39.905689;116.435905,39.905548;116.435867,39.905437;116.435844,39.905376;116.435799,39.905327;116.435745,39.905285;116.435692,39.905251;116.435608,39.905220;116.435486,39.905197;116.435394,39.905182;116.434982,39.905178",
"start_time": "0505",
"end_time": "2305",
"via_num": "17",
"via_stops": [
{
"name": "京顺路丽都饭店",
"id": "110100013750006",
"location": "116.476250,39.978569"
},
{
"name": "四元桥东",
"id": "110100013750007",
"location": "116.473488,39.976070"
},
{
"name": "四元桥西",
"id": "110100013750008",
"location": "116.463608,39.967155"
},
{
"name": "三元桥东站",
"id": "110100013750009",
"location": "116.460396,39.964237"
},
{
"name": "三元桥",
"id": "110100013750010",
"location": "116.457916,39.955193"
},
{
"name": "三元东桥西",
"id": "110100013750011",
"location": "116.458076,39.953144"
},
{
"name": "华都饭店",
"id": "110100013750024",
"location": "116.455437,39.949440"
},
{
"name": "新源南路西口",
"id": "110100013750025",
"location": "116.451874,39.947895"
},
{
"name": "塔园村",
"id": "110100013750026",
"location": "116.450363,39.944096"
},
{
"name": "幸福三村",
"id": "110100013750015",
"location": "116.450363,39.940159"
},
{
"name": "工人体育场",
"id": "110100013750016",
"location": "116.450310,39.933025"
},
{
"name": "朝阳医院",
"id": "110100013750017",
"location": "116.450294,39.927547"
},
{
"name": "东大桥路口北",
"id": "110100013750018",
"location": "116.450287,39.924351"
},
{
"name": "芳草地",
"id": "110100013750023",
"location": "116.450294,39.918415"
},
{
"name": "芳草地南",
"id": "110100013750019",
"location": "116.450279,39.914150"
},
{
"name": "永安里路口北",
"id": "110100013750020",
"location": "116.450264,39.910309"
},
{
"name": "日坛路",
"id": "110100013750021",
"location": "116.444725,39.908562"
}
]
}
]
},
"entrance": [],
"exit": [],
"railway": {
"spaces": []
}
},
{
"taxi": [],
"walking": {
"origin": "116.434975,39.905178",
"destination": "116.434448,39.908073",
"distance": "429",
"duration": "367",
"steps": [
{
"instruction": "沿北京站东街步行62米左转",
"road": "北京站东街",
"distance": "62",
"duration": [],
"polyline": "116.434975,39.905178;116.435478,39.905197;116.435608,39.905220;116.435699,39.905254",
"action": "左转",
"assistant_action": []
},
{
"instruction": "沿建国门南大街步行319米左转",
"road": "建国门南大街",
"distance": "319",
"duration": [],
"polyline": "116.435699,39.905254;116.435623,39.905735;116.435539,39.906200;116.435463,39.906509;116.435364,39.906723;116.435211,39.906971;116.435112,39.907215;116.435051,39.907452;116.435036,39.907829;116.435013,39.908073",
"action": "左转",
"assistant_action": []
},
{
"instruction": "步行48米",
"road": [],
"distance": "48",
"duration": [],
"polyline": "116.435005,39.908073;116.434448,39.908073",
"action": [],
"assistant_action": []
}
]
},
"bus": {
"buslines": []
},
"entrance": [],
"exit": [],
"railway": {
"spaces": []
}
}
]
}
]
}
}
}
接口地址:http://route.showapi.com/2127-15 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 avoidroad String 否 避让道路名 只支持一条避让道路destination String 116.481028,39.989643是 目的地 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。destinationid String 否 目的地poiid 当终点为POI时,建议填充此值。destinationtype String 否 终点的poi类别 当用户知道终点POI的类别时候,建议填充此值number String 否 填入除省份及标点之外,车牌的字母和数字(需大写)。用于判断限行相关。 例如:NH1N11origin String 116.434446,39.90816是 出发点 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 由于在实际使用过程中,存在定位飘点的情况。 为了解决此类问题,允许传入多个起点用于计算车头角度。规划路径时以最后一个坐标对进行规划。 格式为x1,y1|x2,y2|x3,y3。 最多允许传入3个坐标对,每对坐标之间距离必须超过2m。 虽然对每对坐标之间长度没有上限,但是如果超过4米会有概率性出现不准确的情况。originid String 否 出发点poiid 当起点为POI时,建议填充此值。origintype String 否 起点的poi类别 当用户知道起点POI的类别时候,建议填充此值province String 否 用汉字填入车牌省份缩写,用于判断是否限行 例如:京strategy Number 0 否 驾车选择策略 下方策略 0~9的策略,仅会返回一条路径规划结果。 下方10~20的策略,会返回多条路径规划结果。(高德地图APP策略也包含在内) 下方策略仅返回一条路径规划结果 0,不考虑当时路况,返回耗时最短的路线,但是此路线不一定距离最短 1,不走收费路段,且耗时最少的路线 2,距离最短的路线,但是不会考虑路况 3,不走快速路,例如京通快速路 4,躲避拥堵的路线,但是可能会存在绕路的情况,耗时可能较长 5,多策略(同时使用速度优先、费用优先、距离优先三个策略计算路径)。 其中必须说明,就算使用三个策略算路,会根据路况不固定的返回一~三条路径规划信息。 6,不走高速,但是不排除走其余收费路段 7,不走高速且避免所有收费路段 8,躲避收费和拥堵,可能存在走高速的情况,并且考虑路况不走拥堵路线,但有可能存在绕路和时间较长 9,不走高速且躲避收费和拥堵 下方策略返回多条路径规划结果 10,返回结果会躲避拥堵,路程较短,尽量缩短时间 11,返回结果时间最短,距离最短 (由于有更优秀的算法,建议不使用此值) 12,返回的结果考虑路况,尽量躲避拥堵而规划路径,与高德地图的“躲避拥堵”策略一致 13,返回的结果不走高速,与高德地图“不走高速”策略一致 14,返回的结果尽可能规划收费较低甚至免费的路径,与高德地图“避免收费”策略一致 15,返回的结果考虑路况,尽量躲避拥堵而规划路径,并且不走高速,与高德地图的“躲避拥堵&不走高速”策略一致 16,返回的结果尽量不走高速,并且尽量规划收费较低甚至免费的路径结果,与高德地图的“避免收费&不走高速”策略一致 17,返回路径规划结果会尽量的躲避拥堵,并且规划收费较低甚至免费的路径结果,与高德地图的“躲避拥堵&避免收费”策略一致 18,返回的结果尽量躲避拥堵,规划收费较低甚至免费的路径结果,并且尽量不走高速路,与高德地图的“避免拥堵&避免收费&不走高速”策略一致 19,返回的结果会优先选择高速路,与高德地图的“高速优先”策略一致 20,返回的结果会优先考虑高速路,并且会考虑路况躲避拥堵,与高德地图的“躲避拥堵&高速优先”策略一致...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-15","my_appId","my_appSecret") .addTextPara("avoidroad","") .addTextPara("destination","116.481028,39.989643") .addTextPara("destinationid","") .addTextPara("destinationtype","") .addTextPara("number","") .addTextPara("origin","116.434446,39.90816") .addTextPara("originid","") .addTextPara("origintype","") .addTextPara("province","") .addTextPara("strategy","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1 结果状态值,值为0或1 0:请求失败;1:请求成功info String OK 返回状态说明 status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表infocode String 10000 详情参阅info状态表count String 1 驾车路径规划方案数目route Object 驾车路径规划信息列表- origin String 116.434446,39.90816 起点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位- destination String 116.481028,39.989643 终点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位- taxi_cost String 33 打车费用 单位:元- paths Object[] 驾车换乘方案- 0 Object - distance String 11948 行驶距离 单位:米- duration String 1765 预计行驶时间 单位:秒- strategy String 速度最快 导航策略- tolls String 0 此导航方案道路收费 单位:元- toll_distance String 0 收费路段距离- steps Object[] 导航路段- 0 Object 导航路段- instruction String 沿建国门内大街向东行驶193米左转 行驶指示- orientation String 东 方向- road String 建国门内大街 道路名称- distance String 193 此路段距离 单位:米- tolls String 0 此段收费 单位:元- toll_distance String 0 收费路段距离 单位:米- toll_road String[] [] 主要收费道路- duration String 109 持续的时间- polyline String 116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302;116.43499,39.908279;116.43528,39.908268;116.435745,39.90826;116.436264,39.90826;116.436508,39.90826;116.436661,39.908287 此路段坐标点串 格式为坐标串,如:116.481247,39.990704;116.481270,39.990726- action String 左转 导航主要动作 详见驾车动作列表- assistant_action String[] [] 导航辅助动作 详见驾车动作列表- tmcs Object[] 驾车导航详细信息 其中包含tmc对象- 0 Object - lcode String[] []- distance String 40 此段路的长度 单位:米- status String 畅通 此段路的交通情况 未知、畅通、缓行、拥堵、严重拥堵- polyline String 116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302 此段路的轨迹 规格:x1,y1;x2,y2- cities Object[] - 0 Object - name String 北京城区- citycode String 010 参见 adcode参数表- adcode String 110100 参见 adcode参数表- districts Object[] 区域- 0 Object - name String 东城区- adcode String 110101 参见 adcode参数表- restriction String 0 限行结果 0 代表限行已规避或未限行,即该路线没有限行路段 1 代表限行无法规避,即该线路有限行路段- traffic_lights String 7 红绿灯个数...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "7f071715bac74df19e4c908f865cc3de",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"info": "OK",
"infocode": "10000",
"count": "1",
"route": {
"origin": "116.434446,39.90816",
"destination": "116.481028,39.989643",
"taxi_cost": "33",
"paths": [
{
"distance": "11948",
"duration": "1765",
"strategy": "速度最快",
"tolls": "0",
"toll_distance": "0",
"steps": [
{
"instruction": "沿建国门内大街向东行驶193米左转",
"orientation": "东",
"road": "建国门内大街",
"distance": "193",
"tolls": "0",
"toll_distance": "0",
"toll_road": [],
"duration": "109",
"polyline": "116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302;116.43499,39.908279;116.43528,39.908268;116.435745,39.90826;116.436264,39.90826;116.436508,39.90826;116.436661,39.908287",
"action": "左转",
"assistant_action": [],
"tmcs": [
{
"lcode": [],
"distance": "40",
"status": "畅通",
"polyline": "116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302"
}
],
"cities": [
{
"name": "北京城区",
"citycode": "010",
"adcode": "110100",
"districts": [
{
"name": "东城区",
"adcode": "110101"
}
]
}
]
}
],
"restriction": "0",
"traffic_lights": "7"
}
]
}
}
}
接口地址:http://route.showapi.com/2127-16 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 destination String 116.481028,39.989643是 目的地 规则: lon,lat(经度,纬度), “,”分割 如117.500244, 40.417801 经纬度小数点不超过6位origins String 116.434446,39.90816是 出发点 支持100个坐标对,坐标对见用“| ”分隔;经度和纬度用","分隔type String 否 路径计算的方式和方法 0:直线距离 1:驾车导航距离(仅支持国内坐标)。 必须指出,当为1时会考虑路况,故在不同时间请求返回结果可能不同。 此策略和driving接口的 strategy=4策略一致 2:公交规划距离(仅支持同城坐标) 3:步行规划距离(仅支持5km之间的距离)...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-16","my_appId","my_appSecret") .addTextPara("destination","116.481028,39.989643") .addTextPara("origins","116.434446,39.90816") .addTextPara("type","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 status String 1 返回结果状态值,值为0或1,0表示请求失败;1表示请求成功info String OK 返回状态说明,status为0时,info返回错误原因;否则返回“OK”。详情参阅info状态表infocode String 10000 详情参阅info状态表results Object[] 距离信息列表- 0 Object 距离信息- origin_id String 1 起点坐标,起点坐标序列号(从1开始)- dest_id String 1 终点坐标,终点坐标序列号(从1开始)- distance String 11934 路径距离,单位:米- duration String 1380 预计行驶时间,单位:秒- info String 仅在出错的时候显示该字段。大部分显示“未知错误” 由于此接口支持批量请求,建议不论批量与否用此字段判断请求是否成功- code String 仅在出错的时候显示此字段。 在驾车模式下: 1,指定地点之间没有可以行车的道路 2,起点/终点 距离所有道路均距离过远(例如在海洋/矿业) 3,起点/终点不在中国境内...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "396ad20f6adf43e79ff8087cca20641f",
"showapi_res_code": 0,
"showapi_res_body": {
"status": "1",
"info": "OK",
"infocode": "10000",
"results": [
{
"origin_id": "1",
"dest_id": "1",
"distance": "11934",
"duration": "1800"
}
]
}
}
接口地址:http://route.showapi.com/2127-17 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 origin String 117.500244,40.417801是 出发点经纬度填入规则:X,Y,采用","分隔,例如“ 117.500244, 40.417801 ”小数点后不得超过6位destination String 118.500244,40.417801是 目的地经纬度 填入规则:X,Y,采用","分隔,例如“ 117.500244, 40.417801 ” 小数点后不得超过6位
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-17","my_appId","my_appSecret") .addTextPara("origin","117.500244,40.417801") .addTextPara("destination","118.500244,40.417801") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 data Object - paths Object[] 骑行方案列表信息- 0 Object - duration Number 27015 起终点的骑行时间- distance Number 112562 起终点的骑行距离- steps Object[] 具体骑行结果- 0 Object - orientation String 东 此段路骑行方向- duration Number 16 此段路骑行耗时- distance Number 65 此段路骑行距离- polyline String 117.500838,40.417921;117.50122,40.41799;117.50122,40.41799;117.501584,40.41806 此段路骑行的坐标点- action String 左转 此段路骑行主要动作- instruction String 向东骑行65米左转 路段骑行指示- assistant_action String 此段路骑行辅助动作- road String 此段路道路名称- origin String 117.500244,40.417801 起点坐标- destination String 118.500244,40.417801 终点坐标errmsg String OK 返回状态说明errcode Number 0 返回结果码 0,表示成功...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "81e97dfe31414dd58d56959d26b698bc",
"showapi_res_body": {
"data": {
"paths": [
{
"duration": 27015,
"distance": 112562,
"steps": [
{
"orientation": "东",
"duration": 16,
"distance": 65,
"polyline": "117.500838,40.417921;117.50122,40.41799;117.50122,40.41799;117.501584,40.41806",
"action": "左转",
"instruction": "向东骑行65米左转",
"assistant_action": "",
"road": ""
}
]
}
],
"origin": "117.500244,40.417801",
"destination": "118.500244,40.417801"
},
"errmsg": "OK",
"errcode": 0
}
}
接口地址:http://route.showapi.com/2127-18 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 ... 2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 origin String 117.500244,40.417801是 出发点经纬度destination String 115.500244,40.417801是 目的地经纬度size String 1是 车辆大小 高德此分类依据国标 1:微型车,2:轻型车(默认值),3:中型车,4:重型车height String 1.6 否 车辆高度,单位米,取值[0 – 25.5]米,默认 1.6 米width String 2.5 否 车辆宽度,单位米,取值[0 – 25.5]米,默认 2.5 米load String 0.9 否 车辆总重,单位吨,取值[0 – 6553.5]吨,默认 0.9 吨,总重的含义是核定载重加上车辆自重的总质量。weight String 10 否 货车核定载重,单位吨,取值[0 – 6553.5]吨,默认 10 吨axis String 2 否 车辆轴数 单位个,取值[0 –255]个,默认 2个轴province String 否 车牌省份 用汉字填入车牌省份缩写。用于判断是否限行number String 否 车牌详情 填入除省份及标点之外的字母和数字(需大写),用于判断限行相关。 支持6位传统车牌和7位新能源车牌。cartype String 0 否 车辆类型 0:普通货车(默认值) 1:纯电动货车 2:插电混动货车showpolyline String 1 否 是否返回路线数据 当取值为1时,steps与tmcs下的polyline数据会正常返回;当取值为0时,steps与tmcs下的polyline数据返回"";nosteps String 0 否 当取值为0时,steps字段内容正常返回; 当取值为1时,steps字段内容为空;strategy String 否 1,参照文档说明--选择策略 12; 2,参照文档说明--选择策略 13; 3,参照文档说明--选择策略 14; 4,参照文档说明--选择策略 15; 5,参照文档说明--选择策略 16; 6,参照文档说明--选择策略 17; 7,参照文档说明--选择策略 18; 8,参照文档说明--选择策略 19; 9,参照文档说明--选择策略 20; 10,不考虑路况,返回速度优先的路线,此路线不一定距离最短;如果不需要路况干扰计算结果,推荐使用此策略;(导航SDK货导策略无对应,真实导航时均会考虑路况) 11,返回的结果会考虑路况,躲避拥堵,速度优先以及费用优先;500Km规划以内会返回多条结果,500Km以外会返回单条结果;考虑路况情况下的综合最优策略,推荐使用;对应导航SDK货导策略10;...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2127-18","my_appId","my_appSecret") .addTextPara("origin","117.500244,40.417801") .addTextPara("destination","115.500244,40.417801") .addTextPara("size","1") .addTextPara("height","") .addTextPara("width","") .addTextPara("load","") .addTextPara("weight","") .addTextPara("axis","") .addTextPara("province","") .addTextPara("number","") .addTextPara("cartype","") .addTextPara("showpolyline","") .addTextPara("nosteps","") .addTextPara("strategy","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 0 易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示 showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id ... 2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述 data Object 数据体- count Number 2 总共返回路线数- route Object 里面包含距离路线信息- paths Object[] - 0 Object - traffic_lights Number 1 此方案红绿灯总数- duration Number 2724 此方案的耗时- distance Number 14981 此方案的行驶距离- toll_distance Number 0 此导航方案道路收费距离长度- restriction Number 0 限行结果 0,未知(未输入完整/正确车牌号信息时候显示) 1,已规避限行 2,起点限行 3,途径点在限行区域内(设置途径点才出现此报错) 4,途径限行区域 5,终点限行- strategy String 避免拥堵 导航策略- steps Object[] 具体方案- 0 Object - orientation String 东 方向- duration Number 100 此方案的耗时- distance Number 120 此方案的行驶距离- toll_road String 主要收费道路- toll_distance Number 0 此导航方案道路收费距离长度- polyline String 117.500156,40.418043;117.500247,40.41806;117.500911,40.418121;117.501549,40.418216 此路段的坐标点- cities Object[] 途径城市列表(此节点及子节点目前还在开发,会在日后实现)- 0 Object - districts String[] [] 途径地- adcode String 130822 途径城市adcode- tmcs Object[] 驾车导航详细信息- 0 Object - distance Number 112 此方案的行驶距离- polyline String 117.500247,40.41806;117.500911,40.418121;117.501549,40.418216 此路段的坐标点- status String 未知 路况 0:未知 1:畅通 2:缓行 3:拥堵- action String 左转 导航主要动作- instruction String 向东行驶120米左转 行驶指示 例如:沿火器营路向南行驶112米左转- assistant_action String 导航辅助动作- tolls Number 0 此导航方案道路收费金额- tolls Number 0 此导航方案道路收费金额- origin String 117.500244,40.417801 起点坐标- destination String 117.600244,40.417801 终点坐标errmsg String OK 返回状态说明 成功时返回OK,否则返回错误原因errcode Number 0 返回结果编码 0表示成功...
返回示例:{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "c707c7d9cd204b85bd23c8df7ca97bca",
"showapi_res_body": {
"data": {
"count": 2,
"route": {
"paths": [
{
"traffic_lights": 1,
"duration": 2724,
"distance": 14981,
"toll_distance": 0,
"restriction": 0,
"strategy": "避免拥堵",
"steps": [
{
"orientation": "东",
"duration": 100,
"distance": 120,
"toll_road": "",
"toll_distance": 0,
"polyline": "117.500156,40.418043;117.500247,40.41806;117.500911,40.418121;117.501549,40.418216",
"cities": [
{
"districts": [],
"adcode": "130822"
}
],
"tmcs": [
{
"distance": 112,
"polyline": "117.500247,40.41806;117.500911,40.418121;117.501549,40.418216",
"status": "未知"
}
],
"action": "左转",
"instruction": "向东行驶120米左转",
"assistant_action": "",
"tolls": 0
}
],
"tolls": 0
}
],
"origin": "117.500244,40.417801",
"destination": "117.600244,40.417801"
}
},
"errmsg": "OK",
"errcode": 0
}
}
易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种API操纵资源。
截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。
电话: 4009988033
微博: http://www.weibo.com/showapi
邮箱: services@showapi.com
QQ: 3007663665
微信: show_api
企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。
电话:173-6457-5198
QQ① 群:792473404
客服 QQ:1643296538
微信客服:binstds
扫描二维码添加客服微信
周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00)
周六 9:00 - 12:00(节假日除外)
进制数据团队
2020.01.01