1. 什么是 Place API？ 5. Place区域检索POI服务 5.1 Place区域检索通用接口参数 5.2 Place区域检索方法示例 5.3 Place区域检索示例方法 7. Place团购检索服务 7.1 区域团购信息检索服务 7.2 商家团购详情查询 Place APIv1.0 访问入口 自2014年9月1日起，我们将废弃Place API v1.0。届时 Place API v1.0将无法正常使用。 1.什么是Place API？ Place API 是一类简单的HTTP接口，用于返回查询某个区域的某类POI数据，且提供单个POI的详情查询服务，用户可以使用C#、C++、Java等开发语言发送HTTP请求且接收json、xml的数据。 Place API 提供区域检索POI服务、POI详情服务与团购信息检索服务、商家团购详情查询。 1. 区域检索POI服务提供三种区域检索方法： 城市内检索（对应JavaScriptAPI的Search方法） 矩形检索（对应JavaScript API的SearchInBound方法） 圆形区域检索（对应JavaScript的SearchNearBy方法）。 2. POI详情服务提供查询单个POI的详情信息，如好评。 3. 团购信息检索服务提供三种区域检索方法： 用户可以使用C# 、C++、Java等开发语言发送HTTP请求且接收JSON、XML的返回数据。 Place API 是一套免费使用的API接口，调用次数限制为10万次/天。 ak是API请求串的必填参数，请先 获取密钥 ，若无百度账号则首先需要 注册百度账号 。 以下是一个关于place API的简单示例，设置检索城市为北京，检索关键字为“饭店”，检索后返回10条数据。 结果说明： 点击上述请求url,返回符合检索条件的json格式的数据。 百度地图Place API服务地址： 域名： http://api.map.baidu.com 服务版本号：较之前版本，v2版本新增参数。 Place方法名：如search表示区域POI查询，detail表示POI详情，eventsearch为团购信息检索，eventdetail为商家团购详情查询。 5.Place区域检索POI服务 以下参数，适用于三种区域检索方法的Place API。 industry_type ：行业类型 注意：设置该字段可提高检索速度和过滤精度。 industry_type取值如下： hotel:宾馆 cater:餐饮 life:生活娱乐 sort_name ：排序字段 取值根据industry_type字段的值而定。 (1)industry_type为hotel时，sort_name取值： default:默认； price:价格 total_score:好评 level：星级 health_score：卫生 distance:距离排序，只有周边检索有效 (2)industry_type取值cater时，sort_name取值： default：默认 taste_rating：口味 price：价格 overall_rating：好评 service_rating：服务 distance:距离排序，只有周边检索有效 (3)industry_type取值life时，sort_name取值： default：默认 price：价格 overall_rating：好评 comment_num：服务 distance：距离排序，只有周边检索有 sort_rule ：排序规则，取值如下：0：从高到低，1：从低到高； price_section ：价格区间；

groupon ：是否有团购，1为有团购，0为无团购； discount ：是否打折，1为有打折，0为无打折； 对于query和region参数，因为这两个参数取值可以是中文或一些特殊字符（如：空格），举例：query可以取值“小吃”，region可以取值“北京”，为了避免提交到后台乱码，所以对于这2个参数值进行编码处理，编码成 UTF-8 字符的二字符十六进制值。 query和region参数取值时候，凡是不在下表中的字符都要进行编码。 如果query和region参数中使用URL保留字字符的字面意思，例如：query关键字取值为"?小吃"，检索关键字包含一个问号，此问号也必须进行编码，"?"的16进制编码为"%3F"，所以整个检索关键字"?小吃"编码后为"%3F%E5%B0%8F%E5%90%83"。 (1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。 (2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。 (3) C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。 (4) php中可以使用函数urlencode对特殊字符进行编码。 Place API根据支持检索的区域类型，提供城市内、矩形、圆形三种检索方法，使用说明如下： 城市检索示例（返回json数据）： 矩形检索示例（返回json数据）: 圆形区域检索示例(返回xml数据)： 4）Place API检索返回结果字段 结果字段（以结果集合里的一条数据为例，灰色表示扩展字段）： 提供查询某个POI点的详情信息，如好评，评价等。 返回值与 Place API检索返回结果字段相同。 服务地址： http://api.map.baidu.com/place/v2/eventsearch? 根据团购关键字、团购分类、区域范围等条件组合检索，支持按团购价格、距离等条件排序。 备注：query和region取值说明详见 编码说明。 http://api.map.baidu.com/place/v2/eventsearch?query=%E7%BE%8E%E9%A3%9F&event=groupon&ampregion=131&bounds=39.915,116.404,39.935,116.435&output=json&page_size=1&ak=E4805d16520de693a3fe707cdc962045 //北京市的“美食”团购信息 返回结果有两种形式，一种是json,另一种为xml,默认为xml格式，下面示例为json格式。 http://api.map.baidu.com/place/v2/eventdetail? 根据POI UID查询当前POI所有的团购详细信息。 http://api.map.baidu.com/place/v2/eventdetail?uid=c14fc238f7fadd4ea5da390f&output=json&ak=6cb3f458a482fcd009414370808ea219 //根据uid: "c14fc238f7fadd4ea5da390f查询该POI对应的所有团购信息。 返回结果有两种形式，一种是json,另一种为xml,默认为xml格式，下面示例为json格式。 v2版本较之v1版本，功能更新详见 更新日志 ，且请求url参数：新增版本号“v2”，修改“key”为“ak”。V2不兼容v1版本的key，若需升级，请重新 获取密钥 。 若需查看v1文档，请访问“ Place APIv1.0 ”。 ©2014 Baidu 使用百度前必读 京ICP证030173号