WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    室内服务
    室内关键词输入提示

    概述

    提供了基于室内地图的关键词搜索建议功能，用户可以通过输入部分关键词获取匹配的室内 POI（兴趣点）名称建议。


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

    请求URL

    该请求为GET请求

    https://apis.map.qq.com/ws/indoor/v1/suggestion
    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
    output 否 string 返回格式：支持JSON/JSONP，默认JSON output=json

    响应结果

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

    调用示例

    // GET请求，注意参数值要进行URL编码
    https://apis.map.qq.com/ws/indoor/v1/suggestion?key=A5UBZ*************UCBDZ&building_id=310000216895&region=310000&keyword=水&floor_num=1&orderby=2&page_size=50&page_index=1&location=31.1439022825385,121.808744730733

    响应示例

    {
    "status": 0,
    "message": "query ok",
    "count": 1,
    "data": [
        {
            "id": "4738380******",
            "title": "睡眠间",
            "address": "上海市浦东新区迎宾大道6000号********",
            "type": 0,
            "location": {
                "lat": 31.1355179602,
                "lng": 121.815595479
            },
            "floor_name": "4F",
            "category": "生活服务:生活服务附属:休息室",
            "distance": 1138,
            "adcode": 310115,
            "province": "上海市",
            "city": "上海市",
            "district": "浦东新区",
            "indoor_name": "睡眠间"
        }
    ],
    "request_id": "497605576******"
}

    本页内容