北京市朝阳区阜通东大街6号
- 产品介绍
- 接口文档
- 服务商
- 官方客服
地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口，提供结构化地址与经纬度之间的相互转化的能力。
逆地理编码
接口地址：http://route.showapi.com/1659-2 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）
支持格式：json
请求方法：HTTP协议，支持GET/POST方法。
三、返回参数/ 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String 0：扣费 表示成功。 -1：不扣费 未查询到信息 remark String 返回说明 regeocodes Object[] 逆地理编码列表 - formatted_address String 结构化地址信息，结构化地址信息包括：省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码 如果坐标点处于海域范围内，则结构化地址信息为：省份＋城市＋区县＋海域信息 - addressComponent Object[] 地址元素列表 - province String 坐标点所在省名称 例如：北京市 - city String 坐标点所在城市名称 当所在城市为北京、上海、天津、重庆四个直辖市时，该字段返回为空 当所在城市属于县级市的时候，此字段为空 - citycode String 城市编码 例如：010 - district String 坐标点所在区 例如：海淀区 - adcode String 行政区编码 例如：110108 - township String 坐标点所在乡镇/街道（此街道为社区街道，不是道路信息） 例如：燕园街道 - towncode String 乡镇街道编码 例如：110101001000 - neighborhood Object[] 社区信息列表 - name String 社区名称 例如：北京大学 - type String POI类型 例如：科教文化服务;学校;高等院校 - building Object[] 楼信息列表 - name String 建筑名称 例如：北京大学 - type String 类型 例如：科教文化服务;学校;高等院校 - streetNumber Object[] 门牌信息列表 - street String 街道名称 例如：中关村北二条 - number String 门牌号 例如：3号 - location String 坐标点 经纬度坐标点：经度，纬度 - direction String 方向 坐标点所处街道方位 - distance String 门牌地址到请求坐标的距离 单位：米 - seaArea String 所属海域信息 例如：渤海 - businessAreas Object[] 经纬度所属商圈列表 - businessArea String 商圈信息 - location String 商圈中心点经纬度 - name String 商圈名称 例如：颐和园 - id String 商圈所在区域的adcode 例如：朝阳区/海淀区 - roads Object[] 道路信息列表 请求参数 extensions 为 all 时返回如下内容 - id String 道路id - name String 道路名称 - distance String 道路到请求坐标的距离 单位：米 - direction String 方位 输入点和此路的相对方位 - location String 坐标点 - roadinters Object[] 道路交叉口列表 请求参数 extensions 为 all 时返回如下内容 - distance String 交叉路口到请求坐标的距离 单位：米 - direction String 方位 输入点相对路口的方位 - location String 路口经纬度 - first_id String 第一条道路id - first_name String 第一条道路名称 - second_id String 第二条道路id - second_name String 第二条道路名称 - pois Object[] poi信息列表 请求参数 extensions 为 all 时返回如下内容 - id String poi的id - name String poi点名称 - type String poi类型 - tel String 电话 - distance String 该POI到请求坐标的距离 单位：米 - direction String 方向 为输入点相对建筑物的方位 - address String poi地址信息 - location String 坐标点 - businessarea String poi所在商圈名称 - aois Object[] aoi信息列表 请求参数 extensions 为 all 时返回如下内容 - id String 所属 aoi的id - name String 所属 aoi 名称 - adcode String 所属 aoi 所在区域编码 - location String 所属 aoi 中心点坐标 - area String 所属aoi点面积 单位：平方米 - distance String 输入经纬度是否在aoi面之中 0，代表在aoi内 其余整数代表距离AOI的距离 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/1659-2","my_appId","my_appSecret") .addTextPara("location","") .addTextPara("poitype","") .addTextPara("radius","") .addTextPara("extensions","") .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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String 0：扣费 表示成功。 -1：不扣费 未查询到信息 remark String 返回说明 regeocodes Object[] 逆地理编码列表 - formatted_address String 结构化地址信息，结构化地址信息包括：省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码 如果坐标点处于海域范围内，则结构化地址信息为：省份＋城市＋区县＋海域信息 - addressComponent Object[] 地址元素列表 - province String 坐标点所在省名称 例如：北京市 - city String 坐标点所在城市名称 当所在城市为北京、上海、天津、重庆四个直辖市时，该字段返回为空 当所在城市属于县级市的时候，此字段为空 - citycode String 城市编码 例如：010 - district String 坐标点所在区 例如：海淀区 - adcode String 行政区编码 例如：110108 - township String 坐标点所在乡镇/街道（此街道为社区街道，不是道路信息） 例如：燕园街道 - towncode String 乡镇街道编码 例如：110101001000 - neighborhood Object[] 社区信息列表 - name String 社区名称 例如：北京大学 - type String POI类型 例如：科教文化服务;学校;高等院校 - building Object[] 楼信息列表 - name String 建筑名称 例如：北京大学 - type String 类型 例如：科教文化服务;学校;高等院校 - streetNumber Object[] 门牌信息列表 - street String 街道名称 例如：中关村北二条 - number String 门牌号 例如：3号 - location String 坐标点 经纬度坐标点：经度，纬度 - direction String 方向 坐标点所处街道方位 - distance String 门牌地址到请求坐标的距离 单位：米 - seaArea String 所属海域信息 例如：渤海 - businessAreas Object[] 经纬度所属商圈列表 - businessArea String 商圈信息 - location String 商圈中心点经纬度 - name String 商圈名称 例如：颐和园 - id String 商圈所在区域的adcode 例如：朝阳区/海淀区 - roads Object[] 道路信息列表 请求参数 extensions 为 all 时返回如下内容 - id String 道路id - name String 道路名称 - distance String 道路到请求坐标的距离 单位：米 - direction String 方位 输入点和此路的相对方位 - location String 坐标点 - roadinters Object[] 道路交叉口列表 请求参数 extensions 为 all 时返回如下内容 - distance String 交叉路口到请求坐标的距离 单位：米 - direction String 方位 输入点相对路口的方位 - location String 路口经纬度 - first_id String 第一条道路id - first_name String 第一条道路名称 - second_id String 第二条道路id - second_name String 第二条道路名称 - pois Object[] poi信息列表 请求参数 extensions 为 all 时返回如下内容 - id String poi的id - name String poi点名称 - type String poi类型 - tel String 电话 - distance String 该POI到请求坐标的距离 单位：米 - direction String 方向 为输入点相对建筑物的方位 - address String poi地址信息 - location String 坐标点 - businessarea String poi所在商圈名称 - aois Object[] aoi信息列表 请求参数 extensions 为 all 时返回如下内容 - id String 所属 aoi的id - name String 所属 aoi 名称 - adcode String 所属 aoi 所在区域编码 - location String 所属 aoi 中心点坐标 - area String 所属aoi点面积 单位：平方米 - distance String 输入经纬度是否在aoi面之中 0，代表在aoi内 其余整数代表距离AOI的距离 ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "a083dde6e5e44144897d14560ecb5860",
"showapi_res_code": 0,
"showapi_res_body": {
"regeocodes": [
{
"addressComponent": {
"businessAreas": [
{
"name": "望京",
"location": "116.47089234140496,39.9976009239991",
"id": "110105"
},
{
"name": "花家地",
"location": "116.47305065693433,39.98350093430656",
"id": "110105"
},
{
"name": "大山子",
"location": "116.48976000793644,39.984900765873",
"id": "110105"
}
],
"district": "朝阳区",
"township": "望京街道",
"adcode": "110105",
"citycode": "010",
"towncode": "110105026000",
"city": [],
"country": "中国",
"streetNumber": {
"direction": "西南",
"number": "6-2号楼",
"distance": "25.9205",
"street": "阜通东大街",
"location": "116.48129,39.9902869"
},
"neighborhood": {
"type": "商务住宅;楼宇;商住两用楼宇",
"name": "方恒国际中心"
},
"province": "北京市",
"building": {
"type": "商务住宅;楼宇;商务写字楼",
"name": "方恒国际中心B座"
}
},
"formatted_address": "北京市朝阳区望京街道方恒国际中心B座方恒国际中心"
}
],
"remark": "查询成功！",
"ret_code": 0
}
}
地理编码
接口地址：http://route.showapi.com/1659-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）
支持格式：json
请求方法：HTTP协议，支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时，enctype=application/x-www-form-urlencoded。
文件上传的POST时，enctype=multipart/form-data。1、系统级参数（所有接入点都需要的参数）：
参数名称 类型 示例值 必须 描述 showapi_appid String 100 是 易源应用id showapi_sign String 698d51a19d8a121ce581499d7b701668 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 address String 是 city String 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/1659-1","my_appId","my_appSecret") .addTextPara("address","北京市朝阳区阜通东大街6号") .addTextPara("city","北京") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String remark String geocodes Object[] - formatted_address String - province String - city String - citycode String - district String - township String - street String - number String - adcode String - location String - level String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "a57ed771b514499e9a6ed787aef47e97",
"showapi_res_code": 0,
"showapi_res_body": {
"geocodes": [
{
"province": "北京市",
"district": "朝阳区",
"township": [],
"building": {
"type": [],
"name": []
},
"citycode": "010",
"adcode": "110105",
"location": "116.483038,39.990633",
"city": "北京市",
"level": "门牌号",
"formatted_address": "北京市朝阳区阜通东大街|6号",
"street": "阜通东大街",
"number": "6号",
"neighborhood": {
"type": [],
"name": []
}
}
],
"remark": "查询成功！",
"ret_code": 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