华为位置服务

连接参数

华为位置服务连接器使用APIkey认证，创建华为位置服务连接时连接参数说明如表1所示。

周边搜索

通过用户传入自己的位置，可以返回周边地点列表。您可以通过提供关键字或指定要搜索的地点的类型来优化搜索结果。

• 输入参数

  用户配置周边搜索执行动作，相关参数说明如表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]。