# 华为位置服务
华为位置服务连接器包含"地点搜索建议"和"地点模糊搜索"等执行动作。
#### 连接参数
华为位置服务连接器使用APIkey认证，创建华为位置服务连接时连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明           | 示例值/默认值                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。      | 华为位置服务的连接。                                                                                                                                                                                                                                                    |
| 描述   | 否  | 对于连接的信息描述说明。 | description                                                                                                                                                                                                                                                   |
| key  | 是  | API密钥。       | 获取方式请参考[API Console操作指南](https://developer.huawei.com/consumer/cn/doc/start/api-0000001062522591)进行配置后，登录[开发者联盟获](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/web-api-preparations-0000001077961278#section8881246152413)取AppKey。 |
   
#### 周边搜索
通过用户传入自己的位置，可以返回周边地点列表。您可以通过提供关键字或指定要搜索的地点的类型来优化搜索结果。
- 输入参数 用户配置周边搜索执行动作，相关参数说明如[表2]所示。
   表2周边搜索输入参数说明 
  | 参数       | 必填 | 说明                                   |
  |:---|:---|:---|
  | 搜索关键字    | 否  | 输入搜索关键字。                             |
  | 搜索半径     | 否  | 搜索半径，单位：米，取值范围：\[1，50000\]，默认50000米。 |
  | 经度       | 是  | 用户定义经度，取值范围：\[-180，180\]。            |
  | 纬度       | 是  | 用户定义纬度，取值范围：\[-90，90\]。              |
  | 每页返回的记录数 | 否  | 每页返回的记录数，取值范围：\[1，20\]，默认20。         |
  | 当前页数     | 否  | 当前页数，取值范围：\[1，60\]，默认1。              |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3周边搜索输出参数说明 
  | 参数    | 说明                          |
  |:---|:---|
  | 返回码   | 返回码。                        |
  | 返回码描述 | 返回码描述。                      |
  | 记录总数  | 如果查询成功，返回记录总数。如果没有结果，返回0。   |
  | 搜索结果  | 如果查询成功，返回搜索结果。如果没有结果，返回空数组。 |
  | 详细地址  | 格式化的地点详细地址。                 |
  | 国家名   | 国家名。                        |
  | 三级行政区 | 国家下面的三级行政区。                 |
  | 一级行政区 | 国家下面的一级行政区，一般是省/州。          |
  | 二级行政区 | 国家下面的二级行政区，一般是市。            |
  | 城市    | 城市。                         |
  | 区/县   | 区/县。                        |
  | 街道号   | 街道号。                        |
  | 街道名   | 街道名。                        |
  | 邮政编码  | 邮政编码。                       |
  | 地点名称  | 地点名称。                       |
  | 地址ID  | 地点的唯一主键。                    |
  | 经度    | 经度，取值范围：\[-180, 180\]。      |
  | 纬度    | 纬度，取值范围：\[-90, 90\]。        |
  | 距离    | 预测地点和传参经纬度之间的直线距离，单位：米。     |
     
  
 
#### 关键字搜索
通过指定的关键字和可选的地理范围，查询诸如旅游景点、企业和学校之类的地点。
- 输入参数 用户配置关键字搜索执行动作，相关参数说明如[表4]所示。
   表4关键字搜索输入参数说明 
  | 参数        | 必填 | 说明                                   |
  |:---|:---|:---|
  | 搜索关键字     | 是  | 输入搜索关键字。                             |
  | 搜索结果返回的语言 | 否  | 搜索结果返回的语言。                           |
  | 搜索半径      | 否  | 搜索半径，单位：米，取值范围：\[1，50000\]，默认50000米。 |
  | 地点经度      | 否  | 地点经度，取值范围：\[-180，180\]。              |
  | 地点纬度      | 否  | 地点纬度，取值范围：\[-90，90\]。                |
  | 每页返回的记录数  | 否  | 每页返回的记录数，取值范围：\[1，20\]，默认20。         |
  | 当前页数      | 否  | 当前页数，取值范围：\[1，60\]，默认1。              |
     
  - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
     表5关键字搜索输出参数说明 
    | 参数    | 说明                          |
    |:---|:---|
    | 返回码   | 返回码。                        |
    | 返回码描述 | 返回码描述。                      |
    | 记录总数  | 如果查询成功，返回记录总数。如果没有结果，返回0。   |
    | 搜索结果  | 如果查询成功，返回搜索结果。如果没有结果，返回空数组。 |
    | 详细地址  | 格式化的地点详细地址。                 |
    | 国家名   | 国家名。                        |
    | 三级行政区 | 国家下面的三级行政区。                 |
    | 一级行政区 | 国家下面的一级行政区，一般是省/州。          |
    | 二级行政区 | 国家下面的二级行政区，一般是市。            |
    | 城市    | 城市。                         |
    | 区/县   | 区/县。                        |
    | 街道号   | 街道号。                        |
    | 街道名   | 街道名。                        |
    | 邮政编码  | 邮政编码。                       |
    | 地点名称  | 地点名称。                       |
    | 地址ID  | 地点的唯一主键。                    |
    | 经度    | 经度，取值范围：\[-180, 180\]。      |
    | 纬度    | 纬度，取值范围：\[-90, 90\]。        |
    | 距离    | 预测地点和传参经纬度之间的直线距离，单位：米。     |
       
    
   
 
#### 地点搜索建议
可用于在用户键入查询内容的时候，返回建议的查询结果，从而实现查询预测效果。
- 输入参数 用户配置地点搜索建议执行动作，相关参数说明如[表6]所示。
   表6地点搜索建议输入参数说明 
  | 参数        | 必填 | 说明                                   |
  |:---|:---|:---|
  | 搜索关键字     | 否  | 输入搜索关键字。                             |
  | 搜索半径      | 否  | 搜索半径，单位：米，取值范围：\[1，50000\]，默认50000米。 |
  | 搜索结果偏向的经度 | 是  | 经度，取值范围：\[-180，180\]。                |
  | 搜索结果偏向的纬度 | 是  | 纬度，取值范围：\[-90，90\]。                  |
  | 指定国家      | 否  | 在指定的国家内搜索，采用ISO 3166-1 alpha-2。      |
  | 搜索结果返回的语言 | 否  | 搜索结果返回的语言。如果不传，返回地点的当地语言。            |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表7]。
   表7地点搜索建议输出参数说明 
  | 参数    | 说明                          |
  |:---|:---|
  | 返回码   | 返回码。                        |
  | 返回码描述 | 返回码描述。                      |
  | 搜索结果  | 如果查询成功，返回搜索结果。如果没有结果，返回空数组。 |
  | 详细地址  | 格式化的地点详细地址。                 |
  | 国家名   | 国家名。                        |
  | 三级行政区 | 国家下面的三级行政区。                 |
  | 一级行政区 | 国家下面的一级行政区，一般是省/州。          |
  | 二级行政区 | 国家下面的二级行政区，一般是市。            |
  | 城市    | 城市。                         |
  | 区/县   | 区/县。                        |
  | 街道号   | 街道号。                        |
  | 街道名   | 街道名。                        |
  | 邮政编码  | 邮政编码。                       |
  | 地点名称  | 地点名称。                       |
  | 地址ID  | 地点的唯一主键。                    |
  | 经度    | 经度，取值范围：\[-180, 180\]。      |
  | 纬度    | 纬度，取值范围：\[-90, 90\]。        |
     
  
 
#### 地点模糊搜索
根据输入的关键字返回预测的输入关键字和地点查询建议信息。
- 输入参数 用户配置地点模糊搜索执行动作，相关参数说明如[表8]所示。
   表8地点模糊搜索输入参数说明 
  | 参数        | 必填 | 说明                                   |
  |:---|:---|:---|
  | 搜索关键字     | 否  | 输入搜索关键字。                             |
  | 搜索半径      | 否  | 搜索半径，单位：米，取值范围：\[1，50000\]，默认50000米。 |
  | 搜索结果偏向的经度 | 是  | 经度，取值范围：\[-180，180\]。                |
  | 搜索结果偏向的纬度 | 是  | 纬度，取值范围：\[-90，90\]。                  |
  | 搜索结果返回的语言 | 否  | 搜索结果返回的语言。如果不传，返回地点的当地语言。            |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表9]。
   表9地点模糊搜索输出参数说明 
  | 参数    | 说明                          |
  |:---|:---|
  | 返回码   | 返回码。                        |
  | 返回码描述 | 返回码描述。                      |
  | 搜索结果  | 如果查询成功，返回搜索结果。如果没有结果，返回空数组。 |
  | 详细地址  | 格式化的地点详细地址。                 |
  | 国家名   | 国家名。                        |
  | 三级行政区 | 国家下面的三级行政区。                 |
  | 一级行政区 | 国家下面的一级行政区，一般是省/州。          |
  | 二级行政区 | 国家下面的二级行政区，一般是市。            |
  | 城市    | 城市。                         |
  | 区/县   | 区/县。                        |
  | 街道号   | 街道号。                        |
  | 街道名   | 街道名。                        |
  | 邮政编码  | 邮政编码。                       |
  | 地点名称  | 地点名称。                       |
  | 地址ID  | 地点的唯一主键。                    |
  | 经度    | 经度，取值范围：\[-180，180\]。       |
  | 纬度    | 纬度，取值范围：\[-90，90\]。         |