坐标转换服务是一类Web API接口服务;
用于将常用的非百度坐标转换成百度地图中使用的坐标,并可将转化后的坐标在百度地图JavaScript API、Web服务API等产品中使用。
用户可通过该服务,实现非百度坐标系(GPS标准坐标、amap地图坐标、tencent地图坐标、mapbar地图坐标等)到百度坐标系的转换。
单次请求可批量解析100个坐标
https://api.map.baidu.com/geoconv/v1/?coords=114.21892734521,29.575429778924&from=1&to=5&ak=你的密钥 //GET请求
参数名称 | 含义 | 类型 | 举例 | 默认值 | 是否必须 |
---|---|---|---|---|---|
coords | 需转换的源坐标,多组坐标以“;”分隔 (经度,纬度) |
string | 114.21892734521,29.575429778924 |
无 | 是 |
ak | 开发者密钥,申请AK |
string | |
无 | 是 |
from | 源坐标类型:
|
int | 1 | 1 | 否 |
to |
目标坐标类型:
|
int | 5 | 5 | 否 |
sn | 若用户所用AK的校验方式为SN校验时该参数必须 SN生成 |
string | |
无 | 否 |
output |
返回结果格式 |
string | json | json | 否 |
名称 |
类型 | 说明 | |
---|---|---|---|
status |
Int | 本次API访问状态,如果成功返回0,如果失败返回其他数字 | |
result |
json或者xml数组 | 转换结果 | |
|
x | float | 经度 |
|
y | float | 纬度 |
返回码 | 英文描述 | 定义 | 常见原因 |
---|---|---|---|
0 | ok | 正常 | 服务请求正常召回 |
1 | |
内部错误 | |
4 | |
转换失败 | X→GPS时必现,根据法律规定,不支持将任何类型的坐标转换为GPS坐标 |
21 | |
from非法 |
|
22 | |
to非法 |
|
24 | |
coords格式非法 |
|
25 | |
coords个数非法,超过限制 |
|
26 | |
参数错误 | |
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 | 字符 |
URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
坐标转换服务默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("from","to")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持百度坐标(BD09)
注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
不能。根据相关法律规定,不支持将任何一种坐标系坐标转换为GPS标准坐标。
2014年3月6日
V1.0
全新坐标转换API服务发布。