WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    室内服务
    室内搜索

    概述

    提供基于室内地图的精确 POI（兴趣点）搜索功能，用户可以通过关键词在指定楼宇内查找相关的兴趣点信息。


    注：
    本服务属于高级付费服务，如需试用请提交商务合作开通服务试用。

    请求URL

    该请求为GET请求

    https://apis.map.qq.com/ws/indoor/v1/search
    Method：GET

    请求参数

    参数 必填 类型 说明 示例
    key 是 string 开发密钥（Key） key=OB4BZ-D4W3U-***
    building_id 是 string 室内建筑的唯一标示室内id building_id=44010000195
    region 是 string 室内建筑所在城市 region=北京市
    keyword 是 string 搜索关键字，长度最大96个字符
    注：keyword仅支持搜索一个    		 keyword=酒店
    page_size 否 number 每页条数，最大限制为20条，默认为10条 page_size=10
    page_index 否 number 第几页，默认1页 page_index=1
    location 否 string 坐标，纬度在前，经度在后，半角逗号分隔 location=39.91084,116.37353
    floor_num 否 string 用户当前楼层，配合orderby字段使用 floor_num=1
    orderby 否 number 用于定义搜索结果的排序规则，默认值0
    orderby=0 默认排序
    orderby=1 推荐排序
    orderby=2 本楼层优先，按照距离排序    		 orderby=0
    filter_floor_title 否 string 指定单楼层范围查询 filter_floor_title=all
    output 否 string 返回格式：支持JSON/JSONP，默认JSON output=json

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 状态说明
    request_id string 是 本次请求的唯一标识，用于问题排查
    count number 是 结果总数（注：本服务一个查询条件最多返回100条结果）
    data array 是 提示词数组，每项为一个POI对象
    building_id string 是 室内建筑物唯一标识
    id string 是 POI唯一标识
    title string 是 POI名称（为融合后的点位名称）
    address string 是 地址
    location object 是 坐标
    lat number 是 纬度
    lng number 是 经度
    floor_name string 是 楼层名称
    category string 否 POI（地点）分类
    distance number 否 传入location（定位坐标）参数时，返回定位坐标到各POI的直线距离，单位：米
    indoor_name string 否 室内点位名称（为融合前的点位名称）

    调用示例

    // GET请求，注意参数值要进行URL编码
    https://apis.map.qq.com/ws/indoor/v1/search?key=X73BZ********LBBQB&building_id=110000****&region=110000&keyword=541会&filter_category=all&filter_floor_title=all&floor_num=1&page_size=20&page_index=1&orderby=2&native_fields=wisdom_info

    响应示例

    {
    "status": 0,
    "message": "query ok",
    "count": 1,
    "data": [
        {
            "building_id": "11000******",
            "id": "433873********",
            "title": "541会议室",
            "address": "北京市海淀区西北旺东路10号院西区******",
            "location": {
                "lat": 40.04027755037548,
                "lng": 116.27377535104446
            },
            "floor_name": "F5",
            "category": "房产小区:商务楼宇设施:会议室",
            "distance": 0,
            "indoor_name": "541会议室",
                }
            }
        }
    ],
    "request_id": "1a3f43380d*******"
}

    本页内容