检索功能概述

最后更新时间:2025-03-13

地图 SDK 提供的检索能力依托于腾讯地图开放平台提供的 WebService API，所有的检索接口都有配额限制，如果您希望更大的配额，请注册腾讯地图开发者并付费购买所需的配额。在使用检索功能前，请先阅读 WebService API 入门指南。

接入步骤

1. 在腾讯地图控制台的Key管理页面，进入想要开启检索功能的Key设置页面，并勾选WebServiceAPI功能：

   

2. 通过TencentMapOptions 添加apiKey

      TencentMapOptions mTencentMapOptions = new TencentMapOptions();
      mTencentMapOptions.setMapKey("apiKey");
   

3. 生成secretKey

   

签名校验

构造自带key和sk的检索服务

//平台生成的secretKey设置到TencentSearch参数内进行校验
TencentSearch(android.content.Context context, java.lang.String apiKey, java.lang.String secretKey)

注意点

1. 地图SDK的检索功能是对WebServiceAPI服务能力的封装，目前SDK暂时不支持WebServiceAPI服务的授权ip，想要正常使用可勾选域名白名单或签名校验，但白名单输入框需留空。如果需要使用签名校验功能，请根据上述教程来配置。
2. 如若返回的错误码在SDK文档中没有包含，可以参考WebServiceAPI文档中对应的内容，如地点搜索：https://lbs.qq.com/service/webService/webServiceGuide/webServiceSearch 。