Geocoding API v2.0

1.什么是Geocoding？

Geocoding API 是一类简单的HTTP接口，用于提供从地址到经纬度坐标或者从经纬度坐标到地址的转换服务，用户可以使用C# 、C++、Java等开发语言发送HTTP请求且接收JSON、XML的返回数据。

2.功能介绍

Geocoding API包括地址解析和逆地址解析功能。

地理编码：即地址解析，由详细到街道的结构化地址得到百度经纬度信息，且支持名胜古迹、标志性建筑名称直接解析返回百度经纬度。例如：“北京市海淀区中关村南大街27号”地址解析的结果是“lng:116.31985,lat:39.959836”，“百度大厦”地址解析的结果是“lng:116.30815,lat:40.056885”

逆地理编码，即逆地址解析，由百度经纬度信息得到结构化地址信息。例如：“lat:31.325152,lng:120.558957”逆地址解析的结果是“江苏省苏州市虎丘区塔园路318号”。

3.如何使用

百度地图Geocoding API是一套免费对外开放的API，默认配额100万次/天。使用方法：

第一步：申请ak（即获取密钥），若无百度账号则首先需要注册百度账号。

第二步，拼写发送http请求的url，注意需使用第一步申请的ak。

第三步，接收http请求返回的数据（支持json和xml格式）。

Hello, World

以下是一个关于地理编码的简单示例。发送一个地址是“百度大厦”的请求，返回该地址对应的地理坐标。发送请求的url如下：

http://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=E4805d16520de693a3fe707cdc962045&callback=showLocation

结果说明：点击上述请求url，返回地址“百度大厦”解析的json格式的数据。

4.服务地址

百度地图Geocoding API服务地址：

http://api.map.baidu.com/geocoder/v2/

组成说明：

域名：api.map.baidu.com

服务名：geocoder

服务版本号：较之前版本，v2版本新增参数。

5.通用接口参数

6.地理编码服务

地理编码专属请求参数：

对于address字段可能会出现中文或其它一些特殊字符（如：空格），对于类似的字符要进行编码处理，编码成 UTF-8 字符的二字符十六进制值，凡是不在下表中的字符都要进行编码。

附注：

(1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

(2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

(3) C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

(4) php中可以使用函数urlencode对特殊字符进行编码。

地理编码示例

以下是关于地理编码参数使用方法的示例。发送请求显示结果的JavaScript代码此处查看。 
请求示例：对北京市百度大厦进行地理编码查询；
http://api.map.baidu.com/geocoder/v2/?ak=E4805d16520de693a3fe707cdc962045&callback=renderOption&output=json&address=百度大厦&city=北京市

地理编码返回结果字段

json格式的返回值

//带回调函数的返回格式
showLocation&&showLocation( {status: 0,result: {location: {lng: 116.30814954222,lat: 40.056885091681},precise: 1,confidence: 80,level: "商务大厦"}}
)//不带回调函数的返回值
{status: 0,result: {location: {lng: 116.30814954222,lat: 40.056885091681
},
precise: 1,
confidence: 80,
level: "商务大厦"
}
}

xml格式的返回值

<GeocoderSearchResponse><status>0</status><result><location><lat>40.056885091681</lat><lng>116.30814954222</lng></location><precise>1</precise><confidence>80</confidence>    <level>商务大厦</level></result>
</GeocoderSearchResponse>

特别说明： 若解析status字段为OK，但结果内容为空，原因分析及可尝试方法：

• 地址库里无此数据，本次结果为空
• 加入city字段重新解析
• 将过于详细或简单的地址更改至省市区县街道重新解析

7.逆地理编码服务

逆地理编码专属请求参数：

逆地理编码示例 以下是关于逆地理编码参数使用方法的示例。发送请求显示结果的JavaScript代码

状态字段：

json示例：

http://api.map.baidu.com/geocoder/v2/?ak=E4805d16520de693a3fe707cdc962045&callback=renderReverse&location=39.983424,116.322987&output=json&pois=1

xml示例：

http://api.map.baidu.com/geocoder/v2/?ak=E4805d16520de693a3fe707cdc962045&callback=renderReverse&location=39.983424,116.322987&output=xml&pois=1

特别说明：

1.因为Geocoding和反Geocoding使用的门址数据以及算法都不是一样的，所以会出现不能一一对应的现象。

2.逆地址解析location参数传入的参数格式是(纬度lat，经度lng)。

8.返回码状态表

9.升级说明

v2版本较之v1版本，功能更新详见更新日志。若需查看v1文档，请点击目录 “Geocoding APIv1.0”。

若v1版本升级至v2版本，地理/逆地理编码的请求url，参数：新增版本号“v2”，修改“key”为“ak”。v2不兼容v1版本的key，若需升级，请重新获取密钥。