浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
常见问题
更新日志
坐标转换服务

坐标转换服务是一类Web API接口服务;
用于将常用的非百度坐标(目前支持GPS设备获取的坐标、google地图坐标、soso地图坐标、amap地图坐标、mapbar地图坐标)转换成百度地图中使用的坐标,并可将转化后的坐标在百度地图JavaScript API、静态图API、Web服务API等产品中使用。

功能介绍
非百度坐标系转换

用户可通过该服务,实现 非百度坐标系→百度坐标系转换。包括:
WGS84(大地坐标系)→bd09(百度坐标系)
GCJ02(国测局坐标系)→bd09(百度坐标系)

单次请求可批量解析100个坐标

geoconv.png

接口功能介绍
http://api.map.baidu.com/geoconv/v1/?coords=114.21892734521,29.575429778924&from=1&to=5&ak=你的密钥 //GET请求
请求参数
参数名称 含义 类型 举例 默认值 是否必须
coords 需转换的源坐标,多组坐标以“;”分隔
(经度,纬度)
float 114.21892734521,29.575429778924
ak 开发者密钥,用户申请注册的key 申请ak
string
from 源坐标类型:
  • 1:GPS设备获取的角度坐标,wgs84坐标;
  • 2:GPS获取的米制坐标、sogou地图所用坐标;
  • 3:google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,国测局(gcj02)坐标;
  • 4:3中列表地图坐标对应的米制坐标;
  • 5:百度地图采用的经纬度坐标;
  • 6:百度地图采用的米制坐标;
  • 7:mapbar地图坐标;
  • 8:51地图坐标
int 1 1
to
目标坐标类型:
3:国测局(gcj02)坐标;
4:3中对应的米制坐标;
5:bd09ll(百度经纬度坐标);
6:bd09mc(百度米制经纬度坐标)
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对特殊字符进行编码。

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标

坐标转换服务默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)

注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

服务配额

每个开发者账号每天调用“坐标转换”API 服务的总次数(即配额)是有限的。

每个开发者账号每分钟调用“坐标转换”API 服务的总次数(即并发量)是有限的。

若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。


配额及默认并发量说明如下

分类 未认证 个人认证 企业认证
日配额(次) 100,000 300,000 3,000,000
分钟并发数(次/分钟) 6,000 12,000 30,000
服务常见问题
1、服务能将某类坐标系转换为wgs84类型吗?

不能。根据相关法律规定,不支持将任何一种坐标系坐标转换为wgs84类型。

2、我对坐标转换的时延及并发有非常高的需求,是否有离线工具?

我们提供移动端和服务端多种语言的离线坐标转换工具。
此工具仅对合作用户开放,如有需求请联系我们

2014年3月6日

V1.0


产品上线

全新坐标转换API服务发布。