周边搜索(圆形范围)


请求url

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

请求参数(Get请求)

参数名 必填 说明 示例
location 搜索中心点坐标 location=39.976194,116.317987
radius 半径,单位:米,默认5,000米,最大支持10,000米,参数值超过
10,000米时,只返回10,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=男装
filter 按字段值筛选,支持设置为可搜索的自定义number型字段及预设可搜索的系统字段(详见数据定义
1. 支持多条件and
2. 支持 number 型 可搜索字段:
    a) 基本条件表达式:
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例:filter=id in(111,222,333)
3. 系统字段筛选:id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
注:id及ud_id为字符型字段,筛选值要加引号""
例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. 距离函数排序
    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
table_id 表id,即表的唯一标识(table_id在表创建后由系统自动生成,可在地点云数据管理台查询得到) table_id=5d3581dc6ce89813ed0b2cbd
key 开发者key:
1. 您可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限,权限在地点云数据管理台中进行设置
key=EITBZ-OPYAV-***
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请求)

参数名 必填 说明 示例
region 搜索区域名称,格式要求:省,市,区(逗号分割)
支持行政区划代码(adcode)
region=北京市,海淀区
region=130681
keyword 搜索关键字:
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索
keyword=北四环
filter 按字段值筛选,支持设置为可搜索的自定义number型字段及预设可搜索的系统字段(详见数据定义
1. 支持多条件and
2. 支持 number 型 可搜索字段:
    a) 基本条件表达式:
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例:filter=id in(111,222,333)
3. 系统字段筛选:id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
注:id及ud_id为字符型字段,筛选值要加引号""
例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. 距离函数排序
    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
table_id 表id,即表的唯一标识(table_id在表创建后由系统自动生成,可在地点云数据管理台查询得到) table_id=5d3581dc6ce89813ed0b2cbd
key 开发者key:
1. 您可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限,权限在地点云数据管理台中进行设置
key=EITBZ-OPYAV-***
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请求)

参数名 必填 说明 示例
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=北四环
filter 按字段值筛选,支持设置为可搜索的自定义number型字段及预设可搜索的系统字段(详见数据定义
1. 支持多条件and
2. 支持 number 型 可搜索字段:
    a) 基本条件表达式:
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例:filter=id in(111,222,333)
3. 系统字段筛选:id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
注:id及ud_id为字符型字段,筛选值要加引号""
例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. 距离函数排序
    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
table_id 表id,即表的唯一标识(table_id在表创建后由系统自动生成,可在地点云数据管理台查询得到) table_id=5d3581dc6ce89813ed0b2cbd
key 开发者key:
1. 您可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限,权限在地点云数据管理台中进行设置
key=EITBZ-OPYAV-***
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请求)

参数名 必填 说明 示例
location 查询坐标,格式:lat,lng
包含该坐标的polygon的地点会被搜索到
location=39.907293,116.368935
keyword 搜索关键字:
对基础字段 title,address 和 x(自定义字段)下用户指定的最多5个string型字段进行文本搜索
keyword=北四环
filter 按字段值筛选,支持设置为可搜索的自定义number型字段及预设可搜索的系统字段(详见数据定义
1. 支持多条件and
2. 支持 number 型 可搜索字段:
    a) 基本条件表达式:
     <>,=,>=,<=,>,<
    b) in枚举表达式
     例:filter=id in(111,222,333)
3. 系统字段筛选:id in(“11”,“22”,“33”) 及 ud_id in(“aa”,“bb”,“cc”)
注:id及ud_id为字符型字段,筛选值要加引号""
例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. 距离函数排序
    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
table_id 表id,即表的唯一标识(table_id在表创建后由系统自动生成,可在地点云数据管理台查询得到) table_id=5d3581dc6ce89813ed0b2cbd
key 开发者key:
1. 您可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能
2. Key须具备对目标表的数据读取权限,权限在地点云数据管理台中进行设置
key=EITBZ-OPYAV-***
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": "速递"
                }
            }
        ],
//其它内容省略
    }
}

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

已解决
未解决