您当前的位置: Web服务API > 开发指南 > 坐标转换API
坐标转换API

产品介绍

百度地图坐标转换API是一套以HTTP形式提供的坐标转换接口,用于将常用的非百度坐标(目前支持GPS设备获取的坐标、google地图坐标、soso地图坐标、amap地图坐标、mapbar地图坐标)转换成百度地图中使用的坐标,并可将转化后的坐标在百度地图JavaScript API、车联网API、静态图API、web服务API等产品中使用。注意Android SDK、iOS SDK、定位SDK和导航SDK坐标转换服务需单独申请

点击查看示例

适用场景

该接口适用于需将非百度地图坐标的坐标进行转化,进而将其运用到百度地图开发的用户。该接口还支持批量坐标转化,一次最多可转换100个坐标点。

使用限制

使用坐标转服服务前,首先需要登录API控制台申请密钥ak,坐标转换服务属于for server类应用

坐标转换服务每日请求次数上限为10万次,每次最多支持100个坐标点的转换,若需更高配额,请申请开发者认证以获取更高配额和更及时技术支持。

使用方法

第一步,申请密钥(ak),作为访问服务的依据;

第二步,按照请求参数说明拼写发送http请求的url,注意需使用第一步申请的ak;

第三步,接收返回的数据(json或者xml格式)。

注:本接口支持回调。另外,同一个GPS坐标多次转为百度坐标时,每次转换结果都不完全一样,误差在2米范围内,属于正常误差,不影响正常使用。

服务地址

http://api.map.baidu.com/geoconv/v1/?

组成说明:

域名:api.map.baidu.com

服务名:geoconv

服务版本号:v1

服务参数说明

参数 含义 取值范围 是否必须 默认取值
coords 源坐标

格式:经度,纬度;经度,纬度…

限制:最多支持100个

格式举例:

114.21892734521,29.575429778924;

114.21892734521,29.575429778924


ak 开发者密钥
sn 用户的权限签名 若用户所用ak的校验方式为sn校验时该参数必须。 (sn生成算法)
from 源坐标类型

取值为如下:

1:GPS设备获取的角度坐标,wgs84坐标;

2:GPS获取的米制坐标、sogou地图所用坐标;

3:google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,国测局坐标;

4:3中列表地图坐标对应的米制坐标;

5:百度地图采用的经纬度坐标;

6:百度地图采用的米制坐标;

7:mapbar地图坐标;

8:51地图坐标


默认为1,即GPS设备获取的坐标
to 目的坐标类型

有两种可供选择:5、6。

5:bd09ll(百度经纬度坐标),

6:bd09mc(百度米制经纬度坐标);


默认为5,即bd09ll(百度坐标)
output 返回结果格式

json或者xml


json

返回值说明

名称 类型 含义 取值范围
status init 状态码 正常0,异常非0,详细见状态码说明
result json或者xml数组 转换结果 与输入顺序一致
x float 横坐标
y float 纵坐标

接口示例

状态码说明

状态码 含义
1 内部错误
4 转换失败(X→GPS时必现,根据法律规定,不支持将任何类型的坐标转换为GPS坐标)
21 from非法
22 to非法
24 coords格式非法
25 coords个数非法,超过限制

更新日志

2014.3.6坐标转换API v1.0产品发布。