概述

地点搜索（search接口），提供三类范围条件的搜索功能：

1. 指定城市的地点搜索：如在北京搜索餐馆；
2. 圆形区域的地点搜索：一般用于指定位置的周边（附近）地点搜索，如，搜索颐和园附近的酒店；
3. 矩形区域的地点搜索：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形。

请求URL

该请求为GET请求

URL编码

GET请求，注意参数值要进行URL编码（推荐encodeURI），一般浏览器会自动进行url编码，小心二次编码。

请求参数

boundary

搜索地理范围，支持三个范围函数：

[指定地区名称]：

指定地区名称：boundary=region(city_name [,auto_extend][,lat,lng])

     city_name：检索区域名称， 城市名字，如北京市。

     auto_extend：可选参数。 取值1：默认值，若当前城市搜索无结果，则自动扩大范围；
                                                      取值0：仅在当前城市搜索。

      lat,lng：可选参数。 当用户使用泛关键词搜索时（如酒店、超市），这类搜索多为了查找附近，
                                            使用此参数，搜索结果以此坐标为中心，返回就近地点，体验更优。

[周边搜索]：

圆形区域范围 ：nearby(lat,lng<中心坐标>,radius<半径/米>[, auto_extend])
             radius：半径，最大支持1000米
             auto_extend：可选参数,当前范围无结果时，是否自动扩大范围，取值：
                                  1 [默认]自动扩大范围；
                                  0 不扩大

[矩形搜索]：

矩形范围 ：boundary=rectangle(lat,lng<左下/西南>, lat,lng<右上/东北>)

filter

筛选条件：搜索指定分类

最多支持五个分类

基本语法： columnName<筛选列>=value<列值>；
目前支持按POI分类筛选（例：category=分类词），若指定多个分类用英文逗号分隔，支持的分类词可参考：

筛选条件：排除指定分类

基本语法： columnName<筛选列>=value<列值>

*.筛选有电话的地点：tel<>null

*.按POI分类筛选：例 category=分类词，若指定多个分类用英文逗号分隔，最多支持5个；

*.按排除指定POI分类筛选：例：category<>分类词，指获取除指定分类以外的地点，若指定多个分类用英文逗号分隔，最多支持5个；

1. 正常搜索结果

-示例a：指定地区名称

//GET请求示例，注意参数值要进行URL编码
//指定地区名称，不自动扩大范围：boundary=region(北京,0)

https://apis.map.qq.com/ws/place/v1/search? boundary=region(北京,0) &keyword=KFC &page_size=20 &page_index=1 &orderby=_distance &key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

在线测试

boundary
page_size
page_index
keyword
orderby
key

运行

我要说两句

-示例b：周边搜索

//GET请求示例，注意参数值要进行URL编码
//周边搜索（圆形范围）：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)

https://apis.map.qq.com/ws/place/v1/search? boundary=nearby(39.908491,116.374328,1000) &keyword=KFC &page_size=20 &page_index=1 &orderby=_distance &key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

在线测试

boundary
page_size
page_index
keyword
orderby
key

运行

我要说两句

-示例c：矩形搜索

//GET请求示例，注意参数值要进行URL编码
//矩形区域范围：boundary=rectangle(lat,lng<左下/西南>, lat,lng<右上/东北>)

https://apis.map.qq.com/ws/place/v1/search? boundary=rectangle(39.907293,116.368935,39.914996,116.379321) &keyword=KFC &page_size=20 &page_index=1 &orderby=_distance &key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

在线测试

boundary
page_size
page_index
keyword
orderby
key

运行

我要说两句

2.估算搜索结果

当搜索地点无结果时，本服务会返回地址解析的估算结果，如图：

-示例a：估算结果

3.按城市统计

当搜索范围过大，如 boundary=region(全国) 时，而且keyword的搜索结果在各城市无明显权重特别高的时，将返回各城市搜索结果数量的统计数，您可以将此统计结果展示给用户，供用户缩小城市范围，再次发起搜索使用。

-示例a：按城市统计