示例中心
功能在线体验
控制台
您现在的位置: 开发 > 高德地图车机版 > 开发指南 > C++平台 > POI搜索 >

高德 开发 高德地图车机版 开发指南 C++平台 POI搜索

更新时间:2018年11月12日

1. 关键字搜索

 AmapApiRetCode AMapKeyWordSearchReq(STGKeyWordSearch *pKeySearch) 

  • 函数说明

   请求导航进行关键字搜索。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pKeySearch 

float f32Lon   /**< 导航经度坐标 */

float f32Lat    /**< 导航纬度坐标 */

int n32ResultCnt  /**< 搜索结果个数 */ -- 必填

char szKeyWord[MAX_ADDR_NAME_LEN+1] /**< 关键字 */ -- 必填

char szCity[MAX_ADDR_NAME_LEN+1] /**< 城市名字 */


  • 相关函数        

  AMapSearchResultRcvCbReg 

  • 典型应用

一般用于语音交互场合,比如用户通过VR说“天安门”,调用该接口传入关键字名称“天安门”,导航就可以发起搜索。


 AmapApiRetCode AMapSearchResultRcvCbReg(FUNC_SearchResultRcv pFuncCb) 

  • 函数说明

   接收导航关键字搜索的结果。搜索失败的原因详见下面参数说明。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

搜索结果回调函数指针


回调函数定义   typedef int (*FUNC_SearchResultRcv)(EGSearchResult eRet, VEC_POI_INFO vecPoi)

参数

参数说明

 n32Ret 

G_ERR_SEARCH_START = 0, /**< 启动搜索 */

G_ERR_SEARCH_SUCCESS, /**< 搜索成功 */

G_ERR_SEARCH_FAILED, /**< 搜索失败 */

G_ERR_SEARCH_INVALID_PARAM, /**< 参数非法 */

G_ERR_SEARCH_NO_DATA, /**< 当前没有相关的数据 */

G_ERR_SEARCH_NO_ROUTE, /**< 当前没有路径 */

G_ERR_SEARCH_NO_SUPPORT, /**< 当前不支持类别 */

 vecPoi 

存放POI搜索结果的vector,每一个结果都是以结构体STPoiInfo形式存储,结构体的具体成员如下:

float f32Lon;                            /**< 导航经度坐标 */

float f32Lat;                            /**< 导航纬度坐标 */

STCoord stShowCoord; /**< 显示纬度 */ 

char szName[MAX_ADDR_NAME_LEN+1]; /**< 名称 */

char szAddr[MAX_ADDR_NAME_LEN+1]; /**< 地址 */

char szTel[MAX_ADDR_NAME_LEN+1]; /**< 电话号码 */

char szReName[MAX_ADDR_NAME_LEN+1]; /**< 重命名/备注名称 */

char strPoiId[MAX_ADDR_NAME_LEN+1]; /**< POI ID */

int i32Distance; /**< POI距离当前车位距离 */

  • 相关函数        

   AMapKeyWordSearchReq 

  • 典型应用

2. 周边搜索

 AmapApiRetCode AMapAroundSearchReq(STAroundSearch *pAroundSearch) 

  • 函数说明

   请求导航进行周边搜索。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pAroundSearch 

搜索条件结构体指针, 具体成员变量如下:

float f32Lon;                            /**< 导航经度坐标 */ 

float f32Lat;                            /**< 导航纬度坐标 */

float f32SearchLon;                      /**< 导航经度坐标 */

float f32SearchLat;                      /**< 导航纬度坐标 */

int n32Range;    /**< 搜索范围 */

EGPoiSortType eSortType;                    /**< 结果排序类型 */

int n32ResultCnt; /**< 搜索结果个数 */  -- 必填 

char szKeyWord[MAX_ADDR_NAME_LEN+1]; /**< 关键字 */  -- 必填

char szCity[MAX_ADDR_NAME_LEN+1]; /**< 城市名字 */


  • 相关函数        

   AMapSearchResultRcvCbReg 

  • 典型应用

一般用于语音交互场合,比如用户通过VR说“附近的酒店,调用该接口传入关键字名称“酒店”,导航就可以发起搜索。


AmapApiRetCode AMapSearchResultRcvCbReg(FUNC_SearchResultRcv pFuncCb)

  • 函数说明

   接收导航周边搜索的结果。搜索失败的原因详见下面参数说明。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

 搜索结果回调函数指针


回调函数定义   typedef int (*FUNC_SearchResultRcv)(EGSearchResult eRet, VEC_POI_INFO vecPoi)

参数说明同关键字搜索。

  • 相关函数        

    AMapAroundSearchReq 

  • 典型应用

3. 沿途搜索

 AmapApiRetCode AMapRouteSearchReq(STRouteSearchCond *pRouteSearch)

  • 函数说明

   请求导航进行沿途搜索。目前支持的POI类型有厕所、ATM、维修站、加油站、停车场、充电桩。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pRouteSearch 

搜索条件结构体指针,具体成员如下:

EPoiType eSearchType; /**< 搜索类型 */ -- 必填 

STCoord stCurrentCoord;/**< 当前所在位置经纬度坐标 */ 

int i32ResultCntMax;/**< 最多返回的POI数量 */ -- 必填 


  • 相关函数        

    AMapRouteSearchResultRcvCbReg 

  • 典型应用

一般用于语音交互场合,比如VR说“沿途的ATM”,调用该接口就可以搜索沿途的ATM信息。


 AmapApiRetCode AMapRouteSearchResultRcvCbReg(FUNC_RouteSearchResultRcv pFuncCb)

  • 函数说明

   接收导航沿途搜索的结果。搜索失败的原因详见下面参数说明。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

沿途搜索结果回调函数指针 ,同关键字搜索 


回调函数定义  typedef int (*FUNC_RouteSearchResultRcv)(EGSearchResult, EPoiType, VEC_POI_INFO)

参数

参数说明

n32Ret  

同关键字搜索

vecPoi 

同关键字搜索

EPoiType 

对应搜索结果的POI类型,具体的枚举类型如下:

E_POI_TYPE_WC, /**< 厕所*/

E_POI_TYPE_ATM, /**< ATM */

E_POI_TYPE_GARAGE, /**< 维修站 */

E_POI_TYPE_GAS_STATION, /**< 加油站 */

E_POI_TYPE_PARK, /**< 停车场 */

E_POI_TYPE_CHARGER,             /**< 充电桩 */

E_POI_TYPE_OTHER = 99, /**< 其他 */


  • 相关函数        

    AMapRouteSearchReq 

  • 典型应用

4、应用内关键字搜索

AmapApiRetCode AMapShowSearchResultInNaviSnd(string strKeyWord, float f32Lat, float f32Lon, string strCityName)

  • 函数说明

    系统侧通过接口传入搜索关键字等信息,调起导航进行搜索,进入导航搜索结果页展示搜索结果 。

  • 参数说明

参数

参数说明

是否必填

格式样例

 strKeyWord

关键字


 f32Lat 

纬度

如39.308890

 f32Lon 

经度

如116.12389

 strCityName 

当前城市名


  • 相关函数        

    AMapSearchInNaviRespcbReg 

  • 典型应用

 VR场景下,关键字搜索结果不通过协议对外透出, 直接在导航侧的HMI上展示。 

5、应用内周边搜索

AmapApiRetCode AMapAroundSearchInNaviReq(STAroundSearch* pSearch)

  • 函数说明

   系统侧通过接口传入周边搜索需要的信息,调起导航进行搜索,进入导航搜索结果页展示搜索结果 。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pSearch 

 搜索条件结构体指针, 具体成员变量如下:

float f32Lon;  /**< 当前所在位置经度坐标(选填): 传空则以当前车标位置为中心点 */ 

float f32Lat;   **< 当前所在位置纬度坐标(选填): 传空则以当前车标位置为中心点 */

float f32SearchLon;  /**< 搜索中心点经度坐标(无效)  */

float f32SearchLat;  /**< 搜索中心点纬度坐标(无效) */

int n32Range; /**< 搜索范围 (选填): 传空则以导航内的搜索范围进行处理 */

EGPoiSortType eSortType; /**< 结果排序类型 (选填): 默认G_POI_SORT_DEFAULT (推荐排序); G_POI_SORT_DISTANCE:距离排序 */

int n32ResultCnt;/**< 搜索结果个数 (选填)*/ 

char szKeyWord[MAX_ADDR_NAME_LEN+1];/**< 关键字 */  -- 必填

char szCity[MAX_ADDR_NAME_LEN+1];/**< 搜索的城市(选填): 传空则以当前车标所在城市  */


  • 相关函数        

   AMapSearchInNaviRespcbReg 

  • 典型应用

 VR场景下,周边搜索结果不通过协议对外透出, 直接在导航侧的HMI上展示。 

6、应用内搜索结果反馈

AmapApiRetCode AMapSearchInNaviRespcbReg(FUNC_SearchInNaviRespRcv pFuncCb)

  • 函数说明

   系统侧注册接收应用内搜索的结果回调。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数定义  typedef int (*FUNC_SearchInNaviRespRcv)(EGSearchResult)

参数

参数说明

EGSearchResult

G_ERR_SEARCH_START, /**< 启动搜索 */

G_ERR_SEARCH_SUCCESS, /**< 搜索成功 */

G_ERR_SEARCH_FAILED, /**< 搜索失败 */

G_ERR_SEARCH_INVALID_PARAM, /**< 参数非法 */

G_ERR_SEARCH_NO_DATA, /**< 当前没有相关的数据 */

G_ERR_SEARCH_NO_ROUTE, /**< 当前没有路径 */

G_ERR_SEARCH_CHARGER_NO_NET, /**< 当前无网络, 不支持充电桩搜索*/

G_ERR_SEARCH_NO_SUPPORT, /**< 当前不支持类别 */

  • 相关函数        

   AMapAroundSearchInNaviReq ; AMapShowSearchResultInNaviSnd

  • 典型应用
示例中心 功能
在线体验
常见问题