周边搜索(圆形范围)



请求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

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
使用jsonp时,必须设置callback

output=jsonp

callback

output=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

区域搜索



请求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=jsonp

callback

output=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

矩形范围搜索



请求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

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=jsonp

callback

output=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

围栏搜索

围栏搜索作用于地点云数据中的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=jsonp

callback

output=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