com.amap.api.services.nearby

## 类 NearbySearch

- java.lang.Object
- - com.amap.api.services.nearby.NearbySearch

- 已过时。
  自7.4.0起不再支持附件功能

      public class NearbySearch
      extends java.lang.Object

  Nearby功能类，该类为单例模式，包含上传、清除、检索用户当前的基础信息和地理信息。
  从以下版本开始:
    2.6.0

- - ### 嵌套类概要

    嵌套类
    限定符和类型 | 类和说明
    --- | ---
    `static interface` | `NearbySearch.NearbyListener` 已过时。 本类为附近检索结果的异步处理回调接口。
    `static class` | `NearbySearch.NearbyQuery` 已过时。 NearbyQuery类为检索附近用户信息的条件类。

  - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static int` | `AMAP` 已过时。 上传的坐标类型为gcj02坐标系，应用于UploadInfo.setCoordType(int coordType)方法。
    `static int` | `GPS` 已过时。 上传的坐标类型为原始GPS坐标系，应用于UploadInfo.setCoordType(int coordType)方法。

  - ### 方法概要

    所有方法 静态方法 实例方法 具体方法 已过时的方法
    限定符和类型 | 方法和说明
    --- | ---
    `void` | `addNearbyListener(NearbySearch.NearbyListener nearbyListener)` 已过时。 设置NearbySearch.NearbyListener监听器对象，用作调用查询周边信息的监听回调函数，可以添加多个。
    `void` | `clearUserInfoAsyn()` 已过时。 清除当前用户的位置信息，异步方法，与自动上传信息方法互斥。
    `static void` | `destroy()` 已过时。 释放NearbySearch单例对象。
    `static NearbySearch` | `getInstance(Context context)` 已过时。 获取NearbySearch单例对象。
    `void` | `removeNearbyListener(NearbySearch.NearbyListener nearbyListener)` 已过时。 移除NearbySearch.NearbyListener监听器对象，可指定移除。
    `NearbySearchResult` | `searchNearbyInfo(NearbySearch.NearbyQuery query)` 已过时。 检索附近的用户信息，同步方法。
    `void` | `searchNearbyInfoAsyn(NearbySearch.NearbyQuery query)` 已过时。 检索附近的用户信息，异步方法。
    `void` | `setUserID(java.lang.String userID)` 已过时。 设置用户id，此id可以是用户在业务逻辑中的私有id，设置的id用于检索结果区分用户，长度不超过32个字符，只能包含英文、数字、下划线、短横杠，反之在上传时会返回13。
    `void` | `startUploadNearbyInfoAuto(UploadInfoCallback callback, int internal)` 已过时。 启动自动上传信息。
    `void` | `stopUploadNearbyInfoAuto()` 已过时。 停止自动上传信息接口。
    `void` | `uploadNearbyInfoAsyn(UploadInfo uploadInfo)` 已过时。 主动上传信息，当没有启动自动上传时可用，用户调用时的时间间隔不低于10s，异步方法。

    - ### 从类继承的方法 java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 字段详细资料

    - #### GPS

          public static final int GPS

      已过时。
      上传的坐标类型为原始GPS坐标系，应用于UploadInfo.setCoordType(int coordType)方法。
      从以下版本开始:
        2.6.0
      另请参阅:
        常量字段值

    - #### AMAP

          public static final int AMAP

      已过时。
      上传的坐标类型为gcj02坐标系，应用于UploadInfo.setCoordType(int coordType)方法。
      从以下版本开始:
        2.6.0
      另请参阅:
        常量字段值

  - ### 方法详细资料

    - #### getInstance

          public static NearbySearch getInstance(Context context)
                                          throws AMapException

      已过时。
      获取NearbySearch单例对象。
      参数:
        `context` - 当前 Activity。
      抛出:
        `AMapException`
      从以下版本开始:
        2.6.0

    - #### addNearbyListener

          public void addNearbyListener(NearbySearch.NearbyListener nearbyListener)

      已过时。
      设置NearbySearch.NearbyListener监听器对象，用作调用查询周边信息的监听回调函数，可以添加多个。
      参数:
        `nearbyListener` - 查询周边信息的监听器。
      从以下版本开始:
        2.6.0

    - #### removeNearbyListener

          public void removeNearbyListener(NearbySearch.NearbyListener nearbyListener)

      已过时。
      移除NearbySearch.NearbyListener监听器对象，可指定移除。
      参数:
        `nearbyListener` - 查询周边信息的监听器。
      从以下版本开始:
        2.6.0

    - #### clearUserInfoAsyn

          public void clearUserInfoAsyn()

      已过时。
      清除当前用户的位置信息，异步方法，与自动上传信息方法互斥。
      从以下版本开始:
        2.6.0

    - #### setUserID

          public void setUserID(java.lang.String userID)

      已过时。
      设置用户id，此id可以是用户在业务逻辑中的私有id，设置的id用于检索结果区分用户，长度不超过32个字符，只能包含英文、数字、下划线、短横杠，反之在上传时会返回13。
      从以下版本开始:
        2.6.0

    - #### startUploadNearbyInfoAuto

          public void startUploadNearbyInfoAuto(UploadInfoCallback callback,
                                                int internal)

      已过时。
      启动自动上传信息。自动上传的信息包括当前用户的id以及位置信息。该方法与单次上传方法互斥，与清除当前用户位置信息方法互斥，直至调用stopUploadNearbyInfoAuto()方法，清除和单次上传的方法会生效。
      参数:
        `callback` - 设置用户数据的回调接口。
        `internal` - 上传时间间隔下线阈值为7000ms,单位为ms。
      从以下版本开始:
        2.6.0

    - #### stopUploadNearbyInfoAuto

          public void stopUploadNearbyInfoAuto()

      已过时。
      停止自动上传信息接口。
      从以下版本开始:
        2.6.0

    - #### uploadNearbyInfoAsyn

          public void uploadNearbyInfoAsyn(UploadInfo uploadInfo)

      已过时。
      主动上传信息，当没有启动自动上传时可用，用户调用时的时间间隔不低于10s，异步方法。
      参数:
        `uploadInfo` - 用户数据对象，上传的信息包括用户id，以及用户位置信息。
      从以下版本开始:
        2.6.0

    - #### searchNearbyInfoAsyn

          public void searchNearbyInfoAsyn(NearbySearch.NearbyQuery query)

      已过时。
      检索附近的用户信息，异步方法。
      参数:
        `query` - 检索条件，详见NearbyQuery类。
      从以下版本开始:
        2.6.0

    - #### searchNearbyInfo

          public NearbySearchResult searchNearbyInfo(NearbySearch.NearbyQuery query)
                                              throws AMapException

      已过时。
      检索附近的用户信息，同步方法。
      参数:
        `query` - 检索条件，详见NearbyQuery类。
      抛出:
        `AMapException`
      从以下版本开始:
        2.6.0

    - #### destroy

          public static void destroy()

      已过时。
      释放NearbySearch单例对象。
      从以下版本开始:
        2.6.0