2015年12月8日 (二) 19:05的版本

什么是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. 团购信息检索服务提供三种区域检索方法：

城市内检索

矩形检索

圆形区域检索

4. 商家团购详情查询。

用户可以使用C# 、C++、Java等开发语言发送HTTP请求且接收JSON、XML的返回数据。

使用说明

使用限制：

Place API 是一套免费使用的API接口，调用次数限制为10万次/天。

ak是API请求串的必填参数，请先获取密钥，若无百度账号则首先需要注册百度账号。

Hello, World示例：

以下是一个关于place API的简单示例，设置检索城市为北京，检索关键字为“饭店”，检索后返回10条数据。

http://api.map.baidu.com/place/v2/search?q=饭店&region=北京&output=json&ak=E4805d16520de693a3fe707cdc962045

Place服务地址

百度地图Place API服务地址：

http://api.map.baidu.com/place/v2/search //v2 place区域检索POI服务
 
http://api.map.baidu.com/place/v2/detail //v2 POI详情服务
 
http://api.map.baidu.com/place/v2/eventsearch //v2 团购信息检索服务
 
http://api.map.baidu.com/place/v2/eventdetail //v2 商家团购信息查询

组成说明：

域名：api.map.baidu.com

服务名：place

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

Place方法名：如search表示区域POI查询，detail表示POI详情，eventsearch为团购信息检索，eventdetail为商家团购详情查询。

Place区域检索POI服务

服务地址：

http://api.map.baidu.com/place/v2/search

Place区域检索通用接口参数

以下参数，适用于三种区域检索方法的Place API。

编码说明：

对于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检索示例：

Place区域检索示例方法

Place API根据支持检索的区域类型，提供城市内、矩形、圆形三种检索方法，使用说明如下：

城市内检索请求参数

城市检索示例（返回json数据）：

http://api.map.baidu.com/place/v2/search?query=银行&region=济南&output=json&ak=E4805d16520de693a3fe707cdc962045

矩形区域检索参数

矩形检索示例（返回json数据）:

http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak=E4805d16520de693a3fe707cdc962045

圆形区域检索参数

圆形区域检索示例(返回xml数据)：

http://api.map.baidu.com/place/v2/search?query=银行&location=39.915,116.404&radius=2000&output=xml&ak=E4805d16520de693a3fe707cdc962045

Place API检索返回结果字段

状态字段

结果字段（以结果集合里的一条数据为例，灰色表示扩展字段）：

Place详情检索服务

服务地址：

http://api.map.baidu.com/place/v2/detail

提供查询某个POI点的详情信息，如好评，评价等。

请求参数说明:

返回值与Place API检索返回结果字段相同。

服务示例：

http://api.map.baidu.com/place/v2/detail?uid=5a8fb739999a70a54207c130&ak=E4805d16520de693a3fe707cdc962045&output=json&scope=2

返回值：

{
    "status": 0,
    "message": "ok",
    "result": {
        "name": "百度大厦员工食堂",
        "location": {
            "lng": 116.308022,
            "lat": 40.056892
        },
        "address": "海淀区上地十街10号(近辉煌国际)",
        "detail": 1,
        "uid": "5a8fb739999a70a54207c130",
        "detail_info": {
            "tag": "美食;其他",
            "detail_url": "http://api.map.baidu.com/place/detail?uid=5a8fb739999a70a54207c130&output=html&source=placeapi_v2",
            "type": "cater",
            "price": "11.0",
            "overall_rating": "4.0",
            "taste_rating": "4.0",
            "service_rating": "4.0",
            "environment_rating": "4.0",
            "image_num": "2",
            "comment_num": "8",
            "shop_hours": "早9点到晚8点",
            "atmosphere": "",
            "featured_service": "",
            "recommendation": "麻辣烫,烤鱼",
            "description": "门店介绍："
        }
    }
}

状态码附录

升级说明

v2版本较之v1版本，功能更新详见更新日志，且请求url参数：新增版本号“v2”，修改“key”为“ak”。V2不兼容v1版本的key，若需升级，请重新获取密钥。

若需查看v1文档，请访问“Place APIv1.0”。