地点云 / 开发指南 / 云搜索API

周边搜索（圆形范围）


请求url

https://apis.map.qq.com/place_cloud/search/nearby // GET请求

请求参数(Get请求)

参数名 必填 说明 示例
key 是 开发者key：
1. 您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限，权限在地点云数据管理台中进行设置		 key=EITBZ-OPYAV-***
table_id 是 表id，即表的唯一标识（table_id在表创建后由系统自动生成，可在地点云数据管理台查询得到） table_id=5d3581dc6ce89813ed*****
location 是 搜索中心点坐标 location=39.976194,116.317987
radius 是 半径，单位：米，默认5,000米，最大支持20,000米，参数值超过
20,000米时，只返回20,000米内的数据		 radius=3000
spatial_rel 否 空间搜索方式，取值：
0 [默认]搜索指定范围内的POI点(location，图1)
1 搜索指定范围内的POI面(polygon，图2)，包括：相交、包含
 spatial_rel=1
auto_extend 否 当前范围无结果时，是否自动扩大搜索，取值：
0 [默认]不自动扩大范围
1 自动扩大范围：当radius设置小于5,000米且搜索无结果 时，会扩大到 5,000米，再无结果时会自动扩展到10,000米		 auto_extend=1
keyword 否 搜索关键字：
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索		 keyword=男装
keyword_fields 否 指定keyword搜索字段：
传入指定字段名，keyword只对指定字段内容进行检索，指定字段必须为基础可检索字段和文本可检索自定义字段（多字段之间使用逗号分隔）
缺省此参数时，默认对基础可检索字段和文本可检索自定义字段进行检索		 keyword_fields=title,address,x.keyword
filter 否 按字段值筛选，支持设置为可搜索的自定义number型字段及预设可搜索的系统字段（详见数据定义）
1. 支持多条件and
2. 支持 number 型 可搜索字段：
    a) 基本条件表达式：
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例：filter=id in(111,222,333)
3. 支持 string 型 可检索字段 = 和 in 条件，例：
      x.source=“tencent” 及 x.source in(“tencent”)
4. 系统字段id及ud_id筛选：
    id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
    注：id及ud_id为字符型字段，筛选值要加引号""
5. 系统字段create_time和update_time筛选，如：
    create_time>1630479360		 例1：
filter=x.price>100 and x.price<300 and x.star=5
例2：
filter=x.floor=5 and x.type in(1,2,3,4) and x.star>=4
orderby 否 排序方式：
1. 指定自定义字段排序
    要求必须为数值型is_index字段，格式：
    x.fields asc或desc： (默认)asc升序，desc为倒序
2. 系统字段create_time和update_time排序
3. 距离函数排序
    orderby=distance(lat,lng) //按与此坐标近到远排序
注意：指定不存在的字段或非数值字段系统将动忽略（不生效）		 orderby=distance(39.908491,116.374328),x.xingji desc,x.price
fields 否 指定返回字段：返回文本数据大小对性能影响较大，建议只获取需要的字段 fields=title,address,location,x.abc
page_size 否 每页条数：默认10条，最大支持200条 page_size=10
page_index 否 页码，默认第1页 page_index=2
output 否 返回格式：支持JSON/JSONP，默认JSON output=json
callback 否 JSONP方式回调函数 callback=function1

调用示例：

// 请求示例（GET方法）
https://apis.map.qq.com/place_cloud/search/nearby?keyword=营业部西城区&location=39.940567,116.343687&radius=1000&auto_extend=1&filter=x.price>18 and x.price<=20 and x.star>=3&orderby=x.price desc&table_id=5d3581dc6ce89813ed0b2cbd&key=开发者key

//响应示例：
{
    "status": 0,
    "message": "成功",
    "result": {
        "count": 2,   //搜索结果总条数，可用于计算分页数
        "data": [    //搜索结果
            {
                "adcode": 110102,
                "address": "中国北京市北京市西城区白云观街9号",
                "city": "北京市",
                "create_time": 1563922425,
                "district": "西城区",
                "id": "5d378ff96ce89813ed5055de",
                "location": {
                    "lat": 39.901309,
                    "lng": 116.343307
                },
                "polygon": "",
                "province": "北京市",
                "tel": "",
                "title": "白云观营业部",
                "ud_id": "9999",
                "update_time": 1563924423,
                "x": {
                    "price": 15,
                    "star": 2,
                    "type": "abc"
                },
                "_distance": 800
            },
            //其它结果省略...
        ]
    }
}

区域搜索


请求url

https://apis.map.qq.com/place_cloud/search/region // GET请求

请求参数(Get请求)

参数名 必填 说明 示例
key 是 开发者key：
1. 您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限，权限在地点云数据管理台中进行设置		 key=EITBZ-OPYAV-***
table_id 是 表id，即表的唯一标识（table_id在表创建后由系统自动生成，可在地点云数据管理台查询得到） table_id=5d3581dc6ce89813ed*******
region 是 搜索区域名称，格式要求：省,市,区（逗号分割）
支持行政区划代码（adcode）		 region=北京市,海淀区
region=130681
keyword 否 搜索关键字：
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索		 keyword=北四环
keyword_fields 否 指定keyword搜索字段：
传入指定字段名，keyword只对指定字段内容进行检索，指定字段必须为基础可检索字段和文本可检索自定义字段（多字段之间使用逗号分隔）
缺省此参数时，默认对基础可检索字段和文本可检索自定义字段进行检索		 keyword_fields=title,address,x.keyword
filter 否 按字段值筛选，支持设置为可搜索的自定义number型字段及预设可搜索的系统字段（详见数据定义）
1. 支持多条件and
2. 支持 number 型 可搜索字段：
    a) 基本条件表达式：
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例：filter=id in(111,222,333)
3. 支持 string 型 可检索字段 = 和 in 条件，例：
      x.source=“tencent” 及 x.source in(“tencent”)
4. 系统字段id及ud_id筛选：
    id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
    注：id及ud_id为字符型字段，筛选值要加引号""
5. 系统字段create_time和update_time筛选，如：
    create_time>1630479360		 例1：
filter=x.price>100 and x.price<300 and x.star=5
例2：
filter=x.floor=5 and x.type in(1,2,3,4) and x.star>=4
orderby 否 排序方式：
1. 指定自定义字段排序
    要求必须为数值型is_index字段，格式：
    x.fields asc或desc： (默认)asc升序，desc为倒序
2. 系统字段create_time和update_time排序
3. 距离函数排序
    orderby=distance(lat,lng) //按与此坐标近到远排序
注意：指定不存在的字段或非数值字段系统将动忽略（不生效）		 orderby=distance(39.908491,116.374328),x.xingji desc,x.price
fields 否 指定返回字段：返回文本数据大小对性能影响较大，建议只获取需要的字段 fields=title,address,location,x.abc
page_size 否 每页条数：默认10条，最大支持200条 page_size=10
page_index 否 页码，默认第1页 page_index=2
output 否 返回格式：支持json(默认)及jsonp
使用jsonp时，必须设置callback		 output=json
callback 否 JSONP方式回调函数 callback=function1

调用示例：

// 请求示例（GET方法）
https://apis.map.qq.com/place_cloud/search/region?region=北京海淀&keyword=北四环&filter=x.price>15 and x.star=3&orderby=x.price desc&table_id=5d3581dc6ce89813ed0b2cbd&key=开发者key

//响应示例：
{
    "status": 0,
    "message": "成功",
    "result": {
        "count": 2,   //搜索结果总条数，可用于计算分页数
        "data": [
            {
                "adcode": 110108,
                "address": "北京市海淀区北四环西路66号",
                "city": "北京市",
                "create_time": 1563914425,
                "district": "海淀区",
                "id": "5d3770b96ce89813ed5055be",
                "location": {
                    "lat": 39.983988,
                    "lng": 116.307709
                },
                "polygon": "",
                "province": "北京市",
                "tel": "",
                "title": "海淀区苏州街营业部",
                "ud_id": "156985",
                "update_time": 1563924044,
                "x": {
                    "price": 18,
                    "star": 3,
                    "type": "快件平信"
                }
            },
            //其它结果省略...
        ]
    }
}

矩形范围搜索


请求url

https://apis.map.qq.com/place_cloud/search/rectangle // GET请求

请求参数(Get请求)

参数名 必填 说明 示例
key 是 开发者key：
1. 您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限，权限在地点云数据管理台中进行设置		 key=EITBZ-OPYAV-***
table_id 是 表id，即表的唯一标识（table_id在表创建后由系统自动生成，可在地点云数据管理台查询得到） table_id=5d3581dc6ce89813e******
rectangle 是 矩形范围由左下（西南）和右上（东北）两个坐标表达，格式：
lat,lng<左下/西南>;lat,lng<右上/东北>		 rectangle=39.905444,116.319157;39.921244,116.337696
spatial_rel 否 空间搜索方式，取值：
0 [默认]搜索指定范围内的POI点(location，图1)
1 搜索指定范围内的POI面(polygon，图2)，包括：相交、包含
 spatial_rel=1
keyword 否 搜索关键字：
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索		 keyword=北四环
keyword_fields 否 指定keyword搜索字段：
传入指定字段名，keyword只对指定字段内容进行检索，指定字段必须为基础可检索字段和文本可检索自定义字段（多字段之间使用逗号分隔）
缺省此参数时，默认对基础可检索字段和文本可检索自定义字段进行检索		 keyword_fields=title,address,x.keyword
filter 否 按字段值筛选，支持设置为可搜索的自定义number型字段及预设可搜索的系统字段（详见数据定义）
1. 支持多条件and
2. 支持 number 型 可搜索字段：
    a) 基本条件表达式：
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例：filter=id in(111,222,333)
3. 支持 string 型 可检索字段 = 和 in 条件，例：
      x.source=“tencent” 及 x.source in(“tencent”)
4. 系统字段id及ud_id筛选：
    id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
    注：id及ud_id为字符型字段，筛选值要加引号""
5. 系统字段create_time和update_time筛选，如：
    create_time>1630479360		 例1：
filter=x.price>100 and x.price<300 and x.star=5
例2：
filter=x.floor=5 and x.type in(1,2,3,4) and x.star>=4
orderby 否 排序方式：
1. 指定自定义字段排序
    要求必须为数值型is_index字段，格式：
    x.fields asc或desc： (默认)asc升序，desc为倒序
2. 系统字段create_time和update_time排序
3. 距离函数排序
    orderby=distance(lat,lng) //按与此坐标近到远排序
注意：指定不存在的字段或非数值字段系统将动忽略（不生效）		 orderby=distance(39.908491,116.374328),x.xingji desc,x.price
fields 否 指定返回字段：返回文本数据大小对性能影响较大，建议只获取需要的字段 fields=title,address,location,x.abc
page_size 否 每页条数：默认10条，最大支持200条 page_size=10
page_index 否 页码，默认第1页 page_index=2
output 否 返回格式：支持json(默认)及jsonp
使用jsonp时，必须设置callback		 output=json
callback 否 JSONP方式回调函数 callback=function1

调用示例：

// 请求示例（GET方法）
https://apis.map.qq.com/place_cloud/search/rectangle?keyword=酒店&rectangle=39.907293,116.368935;39.914996,116.379321&filter=x.price>100 and x.xingji>=3&orderby=x.price desc&table_id=5d3581dc6ce89813ed0b2cbd&key=开发者key

//响应示例：
{
    "status": 0,
    "message": "成功",
    "result": {
        "count": 2,   //搜索结果总条数，可用于计算分页数
        "data": [       //搜索结果数组
            {
                "adcode": 110102,
                "address": "中国北京市北京市西城区三里河路52号",
                "city": "北京市",
                "create_time": 1563870479,
                "district": "西城区",
                "id": "5d36c50f6ce89813ed43c5ea",
                "location": {
                    "lat": 39.911613,
                    "lng": 116.33581400000001
                },
                "polygon": "",
                "province": "北京市",
                "tel": "010-63258661",
                "title": "三里河营业部",
                "ud_id": "100665",
                "update_time": 1563924416,
                "x": {
                    "price": 20,
                    "star": 4,
                    "type": "速递"
                }
            },
            //其它内容省略
        ]
    }
}

围栏搜索

围栏搜索作用于地点云数据中的Polygon（轮廓范围）字段，通过一个坐标点，搜索其所在地点的面状范围。

可用于场景诸如：精准查找附近支持上门服务覆盖的门店，可用于判断某坐标是否在园区内，也可用于终端、运动状态的设备判断触发电子围栏事件等场景。


请求url

https://apis.map.qq.com/place_cloud/search/contain // GET请求

请求参数(Get请求)

参数名 必填 说明 示例
key 是 开发者key：
1. 您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限，权限在地点云数据管理台中进行设置		 key=EITBZ-OPYAV-***
table_id 是 表id，即表的唯一标识（table_id在表创建后由系统自动生成，可在地点云数据管理台查询得到） table_id=5d3581dc6ce89813ed******
location 是 查询坐标，格式：lat,lng
包含该坐标的polygon的地点会被搜索到		 location=39.907293,116.368935
keyword 否 搜索关键字：
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索		 keyword=北四环
keyword_fields 否 指定keyword搜索字段：
传入指定字段名，keyword只对指定字段内容进行检索，指定字段必须为基础可检索字段和文本可检索自定义字段（多字段之间使用逗号分隔）
缺省此参数时，默认对基础可检索字段和文本可检索自定义字段进行检索		 keyword_fields=title,address,x.keyword
filter 否 按字段值筛选，支持设置为可搜索的自定义number型字段及预设可搜索的系统字段（详见数据定义）
1. 支持多条件and
2. 支持 number 型 可搜索字段：
    a) 基本条件表达式：
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例：filter=id in(111,222,333)
3. 支持 string 型 可检索字段 = 和 in 条件，例：
      x.source=“tencent” 及 x.source in(“tencent”)
4. 系统字段id及ud_id筛选：
    id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
    注：id及ud_id为字符型字段，筛选值要加引号""
5. 系统字段create_time和update_time筛选，如：
    create_time>1630479360		 例1：
filter=x.price>100 and x.price<300 and x.star=5
例2：
filter=x.floor=5 and x.type in(1,2,3,4) and x.star>=4
orderby 否 排序方式：
1. 指定自定义字段排序
    要求必须为数值型is_index字段，格式：
    x.fields asc或desc： (默认)asc升序，desc为倒序
2. 系统字段create_time和update_time排序
3. 距离函数排序
    orderby=distance(lat,lng) //按与此坐标近到远排序
注意：指定不存在的字段或非数值字段系统将动忽略（不生效）		 orderby=distance(39.908491,116.374328),x.xingji desc,x.price
fields 否 指定返回字段：返回文本数据大小对性能影响较大，建议只获取需要的字段 fields=title,address,location,x.abc
page_size 否 每页条数：默认10条，最大支持200条 page_size=10
page_index 否 页码，默认第1页 page_index=2
output 否 返回格式：支持json(默认)及jsonp
使用jsonp时，必须设置callback		 output=json
callback 否 JSONP方式回调函数 callback=function1

调用示例：

// 请求示例（GET方法）
https://apis.map.qq.com/place_cloud/search/contain?location=39.907293,116.368935&filter=x.price>10 and x.star>=3&orderby=x.price desc&table_id=5d3581dc6ce89813ed0b2cbd&key=开发者key

//GET方法调用
//响应示例：
{
    "status": 0,
    "message": "成功",
    "result": {
        "count": 2,   //搜索结果总条数，可用于计算分页数
        "data": [
            {
                "adcode": 110108,
                "address": "中国北京市北京市海淀区玉渊潭南路10-2号",
                "city": "北京市",
                "create_time": 1563870479,
                "district": "海淀区",
                "id": "5d36c50f6ce89813ed43c5ea",
                "location": {
                    "lat": 39.911613,
                    "lng": 116.33581400000001
                },
                "polygon": "39.915332,116.309166;39.922968,116.311226;
                            39.922968,116.327019;39.918360,116.329765;
                            39.910724,116.327019;39.908749,116.311741;39.910065,116.310368",
                "province": "北京市",
                "tel": "010-63258661",
                "title": "玉渊潭营业部",
                "ud_id": "665588",
                "update_time": 1563924416,
                "x": {
                    "price": 20,
                    "star": 4,
                    "type": "速递"
                }
            },
           //其它内容省略
        ]
    }
}

这篇文章对您解决问题是否有帮助？

已解决
未解决