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

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

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

坐标转换服务是一类Web API接口服务;
用于将常用的非百度坐标转换成百度地图中使用的坐标,并可将转化后的坐标在百度地图JavaScript API、Web服务API等产品中使用。

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

用户可通过该服务,实现非百度坐标系(GPS标准坐标、amap地图坐标、tencent地图坐标、mapbar地图坐标等)到百度坐标系的转换。

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

geoconv@2x.png

接口功能介绍
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 源坐标类型:
  • 1:GPS标准坐标;
  • 2:搜狗地图坐标;
  • 3:火星坐标(gcj02),即高德地图、腾讯地图和MapABC等地图使用的坐标;
  • 4:3中列举的地图坐标对应的墨卡托平面坐标;
  • 5:百度地图采用的经纬度坐标(bd09ll);
  • 6:百度地图采用的墨卡托平面坐标(bd09mc);
  • 7:图吧地图坐标;
  • 8:51地图坐标;
int 1 1
to
目标坐标类型:
  • 3:火星坐标(gcj02),即高德地图、腾讯地图及MapABC等地图使用的坐标;
  • 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对特殊字符进行编码。

坐标系说明


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

坐标转换服务默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("from","to")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持百度坐标(BD09)

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

服务使用限制

服务相关配额及并发请求限制请访问开发者权益页面查看。

服务常见问题
1、服务能将某类坐标系转换为GPS标准坐标吗?

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

2014年3月6日

V1.0


产品上线

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


  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消