place api http接口使用说明

《place api http接口使用说明》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、PlaceAPIhttp接口使用说明1.1PlaceAPIhttp接口简介PlaceAPIhttp接口（以下简称http接口）是一个供程序员调用的、http形式的地图检索服务接口，且只向百度合作伙伴开放。目前http接口提供的功能包括：矩形区域关键字检索、周边区域关键字检索（也称：圆形区域检索）和城市内关键字检索。http接口主要服务那些非网页程序的调用，例如：C#、C++、Java等开发的应用程序，这些开发语言都能发送http请求且能接收返回数据。http接口可以返回xml和json两种不同形式的的地理数据。目前提供的功能不是很多、以后随着用户需求的收集和总结，会不断完善http接口。

2、1.2PlaceAPIhttp接口使用说明http接口使用分为3个步骤：第一步，申请注册key；第二步，拼写http请求发送的url，url中附带上第一步申请的key值；第三步，接收http请求返回的数据（json或xml格式），如下图示意：申请注册key拼写http请求url&key接收http返回数据1.2.1申请注册key说明用户打开http://dev.baidu.com/wiki/static/mapws/placeapikey/页面，在此页面中申请注册key值。该key主要目的是判断用户请求的url是否合法，且限制用户1天发送的http请求数不能超过1000次。注册页面如下图

3、：填写好信息后，点击生成API密钥按钮就获取到所需的key值了，申请的key值和应用程序名称相关联，既相同的应用程序名称返回的key值是一样的。特别注意：申请key之前会提示用户首先注册百度账号，只有拥有了百度账号，才能顺利的申请key值。1.2.2http接口请求参数说明http接口请求参数主要包括：检索关键字、检索区域（3种选择形式）、输出结果类型（xml或json）,如下表：参数是否必须默认值格式举例含义query(q)是无中关村、百度大厦检索关键字key是无8cb976834235d8cbcde2dce4835ae191用户申请注册的keybounds(bds)可选无38.766

4、23,116.43213,39.54321,116.46773检索矩形区域location可选无38.76623,116.43213周边检索中心点radius(r)可选无2000周边检索半径，单位米region可选无北京检索城市名称：可以是xxx市或xxx县，目前只支持市和县两种形式，像xx省、xx乡还不支持。output否xmljson或xml输出格式json或xml上表中，检索区域参数有3种形式可以指定，分别是：bounds、location+radius和region，请求的url中，这3种形式的检索区域参数必须指定一种。如果3种形式的检索区域参数都指定了，优先选择bounds区域

5、参数，其次是location+radius区域参数，最后是region区域参数。对于query和region参数，因为这两个参数取值可以是中文或一些特殊字符（如：空格），举例：query可以取值“小吃”，region可以取值“北京”，为了避免提交到后台乱码，所以对于这2个参数值进行编码处理，编码成UTF-8字符的二字符十六进制值。query和region参数取值时候，凡是不在下表中的字符都要进行编码。字符集合字符URL非保留字abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_.~URL保留字!*'();:@&=

6、+$,/?%#[]如果query和region参数中使用URL保留字字符的字面意思，例如：query关键字取值为“?小吃”，检索关键字包含了一个问号，此问号也必须进行编码，“？”的16进制编码为“%3F”，所以整个检索关键字“?小吃”编码后为“%3F%E5%B0%8F%E5%90%83”。附注：(1)javascript中一般采用encodeURIComponent函数对特殊字符进行编码。(2)C#中可以使用函数URLEncoder.encode对特殊字符进行编码。(3)Java中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。(4)php中可以使用函数urle

7、ncode对特殊字符进行编码。1.2.3http接口返回数据说明http接口返回数据如下表：{status:'OK',results:[{name:'名称',position:{lat:'纬度:数值',lng:'经度:数值'},address:'地址',telephone:'电话',},more...]}status字段取值有3种，分别是：OK：成功INVILID_KEY：非法密钥，用户没有使用key参数或key参数错误。INVAL