综述

逆地理编码服务，根据用户指定的坐标，得到指定点对应的地理信息、道路信息。返回的地理信息主要是行政编码信息，即指定点对应的省市县，指定点所 在的位置描述，以及最近的 POI 信息，最近或者满足角度条件的道路信息，道路 上距离 指定 点最近 的点 经纬度 。接 口 URL 符 合公 式：[WEBNAME]/[ 服务名称]?st=[子服务名称][&[参数名称]=[参数数值]]*。URL 编码采用的字符编码为 utf-8。 URL 示例：http://serviceaddress/SE_RGC?st=Rgc&point=116.42028,39.91845&cd=wgs84
http://serviceaddress/SE_RGC2?st=Rgc2&point=116.42028,39.91845&cd=wgs84
http://serviceaddress/SE_RGC3?st=Rgc3&point=116.42028,39.91845&roadlevel=9&cd=wgs84
详细说明请参见：SE_RGC说明文档、SE_RGC2说明文档、SE_RGC3说明文档

RGC

描述:

此服务为 SE_RGC 的主服务，完成了 SE_RGC 服务的大部分功能。

参数如下：

参数名称	含义	必有	默认	错误处理	备注
st	服务类型	是	无		取值为 Rgc
point	点坐标	是	无	返回参数错误	经纬度输入采用度为单位，为浮点数。经度与纬度之间使用逗号 分隔。
cd	坐标类型	否	gcj02	无	取值gcj02、wgs84
output	输出模式	否	xml	忽略此参数，取默认值 xml	支持 xml、json 结果输出。默认值 xml
callback	回调函数	否	无		返回结果需要回调的函数名。主要为浏览器 json 调用设计。 返回结果格式为 xml 时，此参数 失效。缺省值为空。
encoding	编码	否	无	如 果 输 入 非法，取默认数 值	支持的输出字符编码分别 是utf8、gbk。默认为 utf8编码

示例:

(1)http://serviceaddress/SE_RGC?st=Rgc&point=116.42028,39.91845&encoding=utf8&cd=wgs84
描述：116.42028,39.91845 对应的地理信息。
XML输出:

<?xml version="1.0" encoding="utf-8" ?> <xml> <!—状态正常--> <status>ok</status> <result> <!—行政区划编码--> <district>11010100</district> <!—行政区划名称--> <district_text>北京市>市辖区>东城区</district_text> </result> </xml>

JSON输出：

{ //状态正常 "status":"ok", "result":{ //行政区划编码 "district": "11010100", //行政区划名称 "district_text":"北京市>市辖区>东城区" } }

(2)错误输出:

XML输出：

<?xml version="1.0" encoding="utf-8" ?> <xml> <!—出错状态--> <status>error</status> <!—出错信息--> <error>不合理的查询请求</error> </xml>

JSON 输出：

{ // 错误状态 "status":"error", "result":{ // 错误信息 "error":"不合理的查询请求" } }

RGC2

参数如下：

参数名称	含义	必有	默认	错误处理	备注
st	服务类型	是	无		取值为 Rgc2
point	点坐标	是	无	返回参数错误	经纬度输入采用度为单位，为浮点数。经度与纬度之间使用逗号 分隔。
cd	坐标类型	否	gcj02	无	取值gcj02、wgs84
angle	偏移方向	否	无	无	行驶方向与正北方向的夹角， 方向值以正北方向为 0 度，顺 时针旋转，单位：1 度。 取值范围：0-359 ; 0（自南向北）; 90（自西向东）; 180（自北向南）; 270（自东向西）; 如果没有该方向的道路返回对 条件模糊匹配的道路信息。
adr	输出poi类型	否	无	无	默认：最近的poi；adr=address有具体道路值的最近的poi；adr=hamlet:最近的村庄
output	输出模式	否	xml	忽略此参数，取默认值 xml	支持 xml、json 结果输出。默认值 xml
callback	回调函数	否	无		返回结果需要回调的函数名。主要为浏览器 json 调用设计。 返回结果格式为 xml 时，此参数 失效。缺省值为空。
encoding	编码	否	无	如 果 输 入 非法，取默认数 值	支持的输出字符编码分别 是utf8、gbk。默认为 utf8编码

返回错误信息说明：

报错信息	含义
参数错误:NaN	经纬度坐标为119,NaN；NaN，26；NaN，NaN就会出现这样的错误信息
不合理的请求:位置超界	经纬度坐标为12,12就会出现这样的错误信息

新增道路字段

name	name2	code	code2	alias	alias2	oldname	oldname2
道路名称	道路名称2	道路名称编号	道路名称2编号	道路名称别名	道路名称2别名	道路名称曾用名	道路名称2曾用名

示例:

(1)http://[SERVER]:[PORT]/SE_RGC2?st=Rgc2&point=116.33851,40.04255&encoding=utf8&type=11&uid=test
描述：查询点 116.33851,40.04255（默认GCJ-02坐标）对应的地理信息。
XML输出:

<?xml version="1.0" encoding="utf-8"?> <xml> <result> <district_text>北京市>北京市>海淀区</district_text> <address>西三旗绿色海岸西80米</address> <road> <oldname>八达岭高速公路</oldname> <code2>G110</code2> <code>G6</code> <lng>116.33853</lng> <distance>2</distance> <lanenumber>两条或三条车道</lanenumber> <roadtype>上下线分离</roadtype> <limit_speed>120.00000</limit_speed> <linkid>87938855</linkid> <urban>1</urban> <name>京藏高速公路</name> <width>(5.5米~13米]</width> <road_level>高速路</road_level> <lat>40.04256</lat> <road_level_code>0</road_level_code> </road> <district>110108000</district> <road_address>京藏高速公路西南2米</road_address> <point> <lng>116.33898</lng> <distance>80</distance> <name>西三旗绿色海岸</name> <dir>西</dir> <lat>40.04298</lat> </point> </result> <status>ok</status> </xml>

JSON输出：

{"result":{"district_text":"北京市>北京市>海淀区","address":"西三旗绿色海岸西80米","road":{"oldname":"八达岭高速公路","code2":"G110","code":"G6","lng":"116.33853","distance":2,"lanenumber":"两条或三条车道","roadtype":"上下线分离","limit_speed":"120.00000","linkid":"87938855","urban":"1","name":"京藏高速公路","width":"(5.5米~13米]","road_level":"高速路","lat":"40.04256","road_level_code":0},"district":"110108000","road_address":"京藏高速公路西南2米","point":{"lng":116.33898,"distance":80,"name":"西三旗绿色海岸","dir":"西","lat":40.04298}},"status":"ok"}

(2)http://[SERVER]:[PORT]/SE_RGC2?st=Rgc2&point=116.33851,40.04255&encodi ng=utf8&type=11&uid=test&cd=wgs84

描述：查询点 116.33851,40.04255 （wgs84坐标）对应的地理信息。

XML输出：

<?xml version="1.0" encoding="utf-8"?> <xml> <result> <district_text>北京市>北京市>海淀区</district_text> <address>停车场东南39米</address> <road> <lng>116.34463</lng> <distance>17</distance> <lanenumber>一条车道</lanenumber> <roadtype>区域内道路</roadtype> <limit_speed>15.00000</limit_speed> <linkid>695482</linkid> <urban>1</urban> <name/> <width>(3米~5.5米]</width> <road_level>其他道路</road_level> <lat>40.04373</lat> <road_level_code>6</road_level_code> </road> <district>110108000</district> <road_address>北17米</road_address> <point> <lng>116.34436</lng> <distance>39</distance> <name>停车场</name> <dir>东南</dir> <lat>40.04407</lat> </point> </result> <status>ok</status> </xml>

JSON输出:

{"result":{"district_text":"北京市>北京市>海淀区","address":"停车场东南39米","road":{"lng":"116.34463","distance":17,"lanenumber":"一条车道","roadtype":"区域内道路","limit_speed":"15.00000","linkid":"695482","urban":"1","name":"","width":"(3米~5.5米]","road_level":"其他道路","lat":"40.04373","road_level_code":6},"district":"110108000","road_address":"北17米","point":{"lng":116.34436,"distance":39,"name":"停车场","dir":"东南","lat":40.04407}},"status":"ok"}

RGC3

参数如下：

参数名称	含义	必有	默认	错误处理	备注
st	服务类型	是	无		取值为 Rgc3
point	点坐标	是	无	返回参数错误	经纬度输入采用度为单位，为浮点数。经度与纬度之间使用逗号 分隔。
cd	坐标类型	否	gcj02	无	取值gcj02、wgs84
angle	偏移方向	否	无	无	行驶方向与正北方向的夹角， 方向值以正北方向为 0 度，顺 时针旋转，单位：1 度。 取值范围：0-359 ; 0（自南向北）; 90（自西向东）; 180（自北向南）; 270（自东向西）; 如果没有该方向的道路返回对 条件模糊匹配的道路信息。
adr	输出poi类型	否	无	无	默认：最近的poi；adr=address有具体道路值的最近的poi；adr=hamlet:最近的村庄
type	查询类型	否	1	忽略 此 参数 ，取 默 认值 1	查询类型取值： 1：地标查询; 10:道路查询; 11:地标和道路查询。 将 多 个值 相加来 支持 多 种 查 询，如 11 表示地标和道路查询。
roadlevel	道路级别	否	9	不合理的请求:道路级别超出范围	指定道路级别以上的一条道路。
output	输出模式	否	xml	忽略此参数，取默认值 xml	支持 xml、json 结果输出。默认值 xml
callback	回调函数	否	无		返回结果需要回调的函数名。主要为浏览器 json 调用设计。 返回结果格式为 xml 时，此参数 失效。缺省值为空。
encoding	编码	否	无	如 果 输 入 非法，取默认数 值	支持的输出字符编码分别 是utf8、gbk。默认为 utf8编码

返回错误信息说明：

报错信息	含义
参数错误:NaN	经纬度坐标为119,NaN；NaN，26；NaN，NaN就会出现这样的错误信息
不合理的请求:位置超界	经纬度坐标为12,12就会出现这样的错误信息
不合理的请求:道路级别超出范围	道路级别为大于9和小于0的整数都会报这个错误

使用场景示例:

使用场景示例：在点116.32845,40.05465最近的一条路是京藏高速公路辅路

url请求： http://[server]:[port]/SE_RGC3?st=Rgc3&roadlevel=9&point=116.32845,40.05465&uid=[uid]&output=json 上述场景请求时不同roadlevel对应的请求结果：

roadlevel取值	返回结果的道路数据
0
1
2
3	京藏高速公路辅路
4	京藏高速公路辅路
5	京藏高速公路辅路
6	京藏高速公路辅路
7	京藏高速公路辅路
8	京藏高速公路辅路
9	京藏高速公路辅路

新增道路字段

name	name2	code	code2	alias	alias2	oldname	oldname2
道路名称	道路名称2	道路名称1编号	道路名称2编号	道路名称1别名	道路名称2别名	道路名称曾用名	道路名称2曾用名

示例:

(1)http://[SERVER]:[PORT]/SE_RGC3?st=Rgc3&point=116.33851,40.04255&adr=&uid=test&output=xml
描述：查询点 116.33851,40.04255对应的地理信息。
XML输出:

<?xml version="1.0" encoding="utf-8"?> <xml> <result> <district_text>北京市>北京市>海淀区</district_text> <address>西三旗绿色海岸西80米</address> <road> <oldname>八达岭高速公路</oldname> <code2>G110</code2> <code>G6</code> <lng>116.33853</lng> <distance>2</distance> <lanenumber>两条或三条车道</lanenumber> <roadtype>上下线分离</roadtype> <limit_speed>120.00000</limit_speed> <linkid>87938855</linkid> <urban>1</urban> <name>京藏高速公路</name> <width>(5.5米~13米]</width> <road_level>高速路</road_level> <lat>40.04256</lat> <road_level_code>0</road_level_code> </road> <district>110108000</district> <road_address>京藏高速公路西南2米</road_address> <point> <lng>116.33898</lng> <distance>80</distance> <name>西三旗绿色海岸</name> <dir>西</dir> <lat>40.04298</lat> </point> </result> <status>ok</status> </xml>

JSON输出:

{"result":{"district_text":"北京市>北京市>海淀区","address":"西三旗绿色海岸西80米","road":{"oldname":"八达岭高速公路","code2":"G110","code":"G6","lng":"116.33853","distance":2,"lanenumber":"两条或三条车道","roadtype":"上下线分离","limit_speed":"120.00000","linkid":"87938855","urban":"1","name":"京藏高速公路","width":"(5.5米~13米]","road_level":"高速路","lat":"40.04256","road_level_code":0},"district":"110108000","road_address":"京藏高速公路西南2米","point":{"lng":116.33898,"distance":80,"name":"西三旗绿色海岸","dir":"西","lat":40.04298}},"status":"ok"}