首页 API接口商城 连接器API接口 高德连接器-通用模板

高德连接器-通用模板

第三方服务商
价格：免费使用  
服务商： 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

1. 高德是什么

高德官网地址是： https://lbs.amap.com/api/webservice/summary/  。

 

高德Web服务API向开发者提供HTTP接口，开发者可通过这些接口使用各类型的地理数据服务，返回结果支持JSON和XML格式。

Web服务API对所有用户开放。使用高德服务之前，需要申请应用Key。不同类型用户可获取不同的数据访问能力。

2. 常规使用流程

    我们在使用高德官方提供的WEB服务时，常规流程如下图所示：

 

调用高德服务时，需要每次把认证key一起发送到服务方。

3. 面临的问题

  • 密钥字段管理

    虽然只是简单地在URL后面放上密钥，但每个接口的密钥字段名、值都是不一样的。如果需要调用多个接口，那开发者就需要在程序中保存、维护这些参数。

  • 权限管理

    在很多情况下，一个账号的密钥可以调用  A、B、C、D多个接口，如果开发者想精细管理，比如某个小组只能调用A，某个小组只能调用BC，这样的情况只能自己编码进行权限管理。

  • IP黑白名单

    哪些IP可以使用您的密钥调用接口，哪些IP不能调用？这个看似简单的功能，很多API服务商却没有提供。

  • 流量、并发控制

    假设一个密钥在多个开发组中共享，每个小组每天能使用多少次调用，并发又能到多少？ 因为API服务商通常对密钥有个总流控，您也不希望某个小组代码有问题而把其他小组的业务全阻塞了。

  • 日志记录

    一个密钥在什么时候，什么IP调用了接口，出入参数分别是什么？对不起，目前绝大部份API服务商没有对此记录。当您对调用量有疑问而希望服务商和您对账时，由于日志的缺失，这将是一笔糊涂账。

  • 负载均衡

    比如您同时在用百度和高德的【IP地址查询】接口，由于两个服务的调用额度、并发限制可能不同，您可以在易源设置这两个节点的负载权重从而分流。

  • 映射输入输出字段

    比如您同时在用百度和高德的【IP地址查询】接口，它们的输入和输出字段是不一样的。您可以通过易源对这两个节点的输入和输出做字段映射、代码级转换，从而把它们的输入输出完全统一。

  • 容灾切换

    项目中同时在用ABC三个接口，A挂了就走B，B再挂了就走C。需要定期检测节点的恢复情况。

 

4.解决方案

对于上一小节提到的问题，解决如下：

  • 密钥字段管理。
  • 权限管理

     通过连接器创建接入点，设置私有用户调用权限控制可使用哪些后端数据。

 

 

  • IP黑白名单

 

  

 

  • 流量、并发控制

 

 

 

  • 日志记录。

 

 

  • 负载均衡。

 

  • 映射输入输出字段。

 

 

如果单纯的字段映射不能应对复杂情况，我们还可以使用【嵌入代码】方式直接修改输入、输出内容。

 

  • 容灾切换

      某个节点熔断后，易源会根据权重或嵌入的代码，将请求数据转至正常的后端节点。

 

 

5. 性能问题

    如果在同一个局域网下进行压力测试，直连时程序做充分优化，易源中转比直连方式的多消耗时间<1ms。网站或APP的响应时间在100ms-1000ms之间是可以接受的，也就是易源增加的时间是整体流程的0.01至0.001的比率，几乎可以忽略不计。这点开销，就像开车从北京到西安有1000公里，中间因为修路多走了1公里，总共由1000到1001公里，多走这1公里对全局可以忽略不计。

 

 

6. 安全问题

  • 易源平台和您签定合作协议，易源保证关键信息加密存储，保证数据安全不泄露，保证无用户授权绝对不连接数据源。
  • 易源公布对外IP，您可以设置IP白名单。

对于高德连接器，易源的IP是：

  • 121.41.60.109
  • 120.26.59.160
  • 120.26.61.225
  • 129.211.129.137

 

 

 

 

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_appidString100是易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668是为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239否客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。 
showapi_res_gzipString1或0否返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称类型默认值示例值必须描述
ipString 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_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,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_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称类型示例值描述
status String1 
info StringOK是否成功的标志
infocode String10000是否成功的编码
province String北京市 
city String北京市 
adcode String110000 
rectangle String116.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
 是
输入城市的编码。具体参数值请见帮助文档，对应文档中的adcode
extensions 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
1
count String
1
info String
OK
infocode String
10000
lives 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
1
info 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
10000
count 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
10000
count 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.417801
info 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
1
status 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" } }

搜索POI

接口地址：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/false
children String
否
是否按照层级展示子POI数据 可选值：children=1 当为0的时候，子POI都会显示。 当为1的时候，子POI会归类到父POI之中。 仅在extensions=all的时候生效
offset String
否
每页记录数据 强烈建议不超过25，若超过25可能造成访问报错
page String
否
当前页数 最大翻页数100
extensions 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
10000
count 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
该城市的adcode
info 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
10000
locations 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/false
datatype 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
10000
count 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
10000
status 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*1024
traffic 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
昆明
 是
城市/跨城规划时的起点城市 目前支持市内公交换乘/跨城公交的起点城市。 可选值：城市名称/citycode
cityd String
否
跨城公交规划时的终点城市 跨城公交规划必填参数。 可选值：城市名称/citycode
date String
否
出发日期 根据出发时间和日期筛选可乘坐的公交路线，格式：date=2014-3-19
destination 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
否
填入除省份及标点之外，车牌的字母和数字（需大写）。用于判断限行相关。 例如:NH1N11
origin 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" } ] } } }

距离测量API

接口地址：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
起点坐标，起点坐标序列号（从１开始）
-  dest_id String
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

 

 

 

 

 

其他服务商
MySQL连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
PostgreSQL连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
高德连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
Memcached-连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
达达-开放平台-订单管理-通用模板
万维易源
免费使用
第三方服务商
查看详情
达达-开放平台-商户管理-通用模板
万维易源
免费使用
第三方服务商
查看详情
Oracle连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
Redis连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
Pika连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
ElasticSearch连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
Influxdb连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
SQL server连接器-通用模板
万维易源
免费使用
第三方服务商
查看详情
热门API推荐
驾考题库 标准中文电码查询 短信 动态活体检测 简体/繁体/火星文转换 汇率查询 身份证号码查询 快递查询 全国天气预报 火车查询
相关API推荐
全国交通违章查询 火车查询 长途汽车 公交地铁查询 全国天气预报 万年历 快递查询 空气质量指数 身份证号码查询 区号查询

Token化数据API交易平台

ABOUT US

OTHER

CONTACT US

  • 邮箱：kf@binstd.com
  • QQ：1643296538
  • 微信：binstds

客服微信

© 2019 binstd.com 进制数据 浙ICP备17047587号-4