发布日期：2025-01-03 19:33    点击次数：185

1.poi周边搜索 周边检索是指以一点为中心（中心点通过location参数指定），搜索中心点附近指定距离范围（搜索半径通过radius参数指定）内的POI点。检索时可通过tags参数指定检索的类型；通过sortby参数进行检索结果的排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。 例：搜索以“116.395884,39. 932154”为中心，1000米范围内价格在200到300的饭店，并将搜索结果按照距离和价格的升序排序。 ?ak=您的ak&geotable_id=****&location=116.395884,39.932154&radius=1000&tags=酒店&sortby=distance:1|price:1&filter=price:200,300 1.1 请求url // GET请求 1.2 请求参数 参数名 参数含义 类型 格式 备注 ak access_key string(50) 字符串 必须 geotable_id geotable主键 uint32 数字 必须 q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 必须 location 检索的中心点 string(25) 逗号分隔的经纬度 必须样例：116.4321,38.76623 coord_type 坐标系 uint32 数字 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 radius 检索半径 uint32 单位为米，默认为1000 可选样例：500 tags 标签 string(45) 空格分隔的多字符串 可选样例：美食 小吃 sortby 排序字段 string “|”分隔的多个检索条件。 格式为sortby={key1}:value1|{key2:val2|key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序 可选 默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1 filter 过滤条件 string(50) |竖线分隔的多个key-value对 key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...] 可选 样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号 page_index 分页索引 uint32 当前页标，从0开始 可选 默认为0 page_size 分页数量 uint32 当前页面最大结果数 可选默认为10，最多为50 callback 回调函数 string(20) js回调函数 可选 sn 用户的权限签名 string(50) 可选 1.3 响应参数（json格式） 参数名 参数含义 类型 备注 status 状态码 int32 0表示成功，其他值详见状态码说明 size 分页参数，当前页返回数量 int32   total 分页参数，所有召回数量 int32   contents poi结果列表 array   uid 数据id string   geotable_id geotable_id string   title poi名称 string   adderss poi地址 string   province poi所属省 string(20)   city poi所属城市 string(20)   district poi所属区 string(20)   coord_type 坐标系定义 int32 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 location 经纬度 array   tags poi的标签 string   distance 距离 int32   weight 权重 int32   {column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回 1.4 请求响应示例 2.poi本地检索 本地检索是指可检索指定区域范围内的poi信息，区域通过region参数来设定，可以是全国范围也可以是小范围的如海淀区。检索时可通过tags参数指定检索类型；通过sortby参数对检索结果进行排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。 例：搜索北京范围内的价格在200到300之间的酒店并将搜索结果按照距离和价格降序排序。 ?region=北京&ak=您的ak&geotable_id=****&tags=酒店&sortby=distance:1|price:1 &filter=price:200,300 2.1 请求url // GET请求 2.2 请求参数 参数名 参数含义 类型 格式 备注 ak access_key string(50) 字符串 必须 geotable_id geotable主键 uint32 数字 必须 q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 必须 coord_type 坐标系 uint32 数字 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 region 检索区域名称 String(25) 市或区的名字，如北京市，海淀区。 可选,此接口推荐填写该参数否则，默认按照全国范围来检索 tags 标签 string(45) 空格分隔的多字符串 可选样例：美食 小吃 sortby 排序字段 string “|”分隔的多个检索条件。 格式为sortby={key1}:value1|{key2:val2|key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序 可选 默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1 filter 过滤条件 string(50) |竖线分隔的多个key-value对 key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...] 可选 样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号 page_index 分页索引 uint32 当前页标，从0开始 可选 默认为0 page_size 分页数量 uint32 当前页面最大结果数 可选默认为10，最多为50 callback 回调函数 string(20) js回调函数 可选 sn 用户的权限签名 string(50) 可选 2.3 响应参数（json格式） 参数名 参数含义 类型 备注 status 状态码 int32 0表示成功，其他值详见状态码说明 size 分页参数，当前页返回数量 int32   total 分页参数，所有召回数量 int32   contents poi结果列表 array   uid 数据id string   geotable_id geotable_id string   title poi名称 string   adderss poi地址 string   province poi所属省 string(20)   city poi所属城市 string(20)   district poi所属区 string(20)   location 经纬度 array   coord_type 坐标系定义 int32 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 tags poi的标签 string 多个tag用空格分隔 distance 距离 int32   weight 权重 int32   {column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回 2.4 请求响应示例 3.poi矩形检索 矩形检索是指可检索指定矩形范围内的poi信息，检索区域通过bounds参数设定的矩形的左下角和右上角的经纬度坐标来确定。检索时可通过tags参数指定检索类型；检索结果可通过sortby参数进行排序（支持多字段排序）；可通过filter参数筛选出指定的数据范围的结果。 例：搜索以“116.30,36.20”为左下角以“117.30,37.20”为右上角的矩形范围内的价格在200到300之间的酒店并将搜索结果按照距离和价格降序排序。 ?ak=您的ak&geotable_id=****bounds=116.30,36.20;117.30,37.20 &sortby=distance:1|price:1&tags=酒店&filer=price:200,300 3.1 请求url // GET请求 3.2 请求参数 参数名 参数含义 类型 格式 备注 ak access_key string(50) 字符串 必须 geotable_id geotable主键 uint32 数字 必须 q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 必须 bounds 矩形区域 String(25) 左下角和右上角的经纬度坐标点。2个点用;号分隔 必须样例：116.30,36.20;117.30,37.20 tags 标签 string(45) 空格分隔的多字符串 可选样例：美食 小吃 coord_type 坐标系 unit32 数字 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 sortby 排序字段 string “|”分隔的多个检索条件。 格式为sortby={key1}:value1|{key2:val2|key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序 可选 默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1 filter 过滤条件 string(50) |竖线分隔的多个key-value对 key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...] 可选 样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号 page_index 分页索引 uint32 当前页标，从0开始 可选 默认为0 page_size 分页数量 uint32 当前页面最大结果数 可选默认为10，最多为50 callback 回调函数 string(20) js回调函数 可选 sn 用户的权限签名 string(50) 可选 3.3 响应参数（json格式） 参数名 参数含义 类型 备注 status 状态码 int32 0表示成功，其他值详见状态码说明 size 分页参数，当前页返回数量 int32   total 分页参数，所有召回数量 int32   contents poi结果列表 array   uid 数据id string   geotable_id geotable_id string   title poi名称 string   adderss poi地址 string   province poi所属省 string(20)   city poi所属城市 string(20)   district poi所属区 string(20)   location 经纬度 array   coord_type 坐标系定义 int32 3代表百度经纬度坐标系统，4代表百度墨卡托系统 tags poi的标签 string   distance 距离 int32   weight 权重 int32   {column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回 3.4 请求响应示例 4.poi详情检索 4.1 请求url {uid} // GET请求 注意：uid为poi点的id值 4.2 请求参数 参数名 参数含义 类型 备注 ak access_key string(50) 必须 geotable_id geotable表主键 int32 必选 coord_type 坐标系 uint32 可选3代表百度经纬度坐标系统 4代表百度墨卡托系统 sn 用户的权限签名 string(50) 可选 4.3 响应参数（json格式） 参数名 参数含义 类型 备注 status 状态码 int32 0代表成功，其它取值含义另行说明 size 分页参数，当前页返回数量 int32   total 分页参数，所有召回数量 int32   contents poi结果列表 array uid 数据id string   geotable_id geotable_id string   title Poi地址 string   adderss poi名称 string   province poi所属省 string   city poi所属城市 string(20)   district poi所属区 string(20)   location 经纬度 array   coord_type 坐标系定义 int32 3代表百度经纬度坐标系统，4代表百度墨卡托系统 tags poi的标签 string   distance 距离 int32   weight 权重 int32   {column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回 4.4 请求响应示例 状态码说明 0 成功 1 服务器内部错误 2 请求参数非法 3 权限校验失败 4 配额校验失败 5 ak不存在或者非法 101 服务禁用 102 不通过白名单或者安全码不对 权限配额相关的部分错误码： 202-205、210、233 无请求权限 231 用户uid，ak不存在 232 用户、ak被封禁 233 sn签名计算错误 210 权限资源不存在 345 分钟配额超额 346 月配额超额 347 年配额超额 348 永久配额超额无请求权限 355 日配额超额 350 配额资源不存在