com.amap.api.maps

## 类 AMapUtils

- java.lang.Object
- - com.amap.api.maps.AMapUtils

-     public class AMapUtils
      extends java.lang.Object

  AMap辅助工具类，包含计算距离、面积、调起高德地图APP进行导航等系列功能。
  AMap utility class, including functions such as calculating distance, area, and invoking the AMap APP for navigation.
  从以下版本开始:
    2.0.2

- - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static int` | `BUS_COMFORT` 公交路径规划策略：（最舒适 : 4） Bus route planning strategy: (Most comfortable : 4)
    `static int` | `BUS_MONEY_LITTLE` 公交路径规划策略：（费用优先 : 1） Bus route planning strategy: (Cost first : 1)
    `static int` | `BUS_NO_SUBWAY` 公交路径规划策略：（不乘地铁 : 5） Bus route planning strategy: (Avoid subway : 5)
    `static int` | `BUS_TIME_FIRST` 公交路径规划策略：（最快捷 : 0） Bus route planning strategy: (Fastest : 0)
    `static int` | `BUS_TRANSFER_LITTLE` 公交路径规划策略：（最少换乘 : 2） Bus route planning strategy: (Least transfers : 2)
    `static int` | `BUS_WALK_LITTLE` 公交路径规划策略：（最少步行 : 3） Bus route planning strategy: (Least walking : 3)
    `static int` | `DRIVING_AVOID_CONGESTION` 驾车路径规划策略：（避免拥堵 : 4） Driving route planning strategy: (Avoid congestion : 4)
    `static int` | `DRIVING_DEFAULT` 驾车路径规划策略：（速度优先 : 0） Driving route planning strategy: (Speed first : 0)
    `static int` | `DRIVING_NO_HIGHWAY` 驾车路径规划策略：（不走高速 : 3） Driving route planning strategy: (Avoid highways : 3)
    `static int` | `DRIVING_NO_HIGHWAY_AVOID_CONGESTION` 驾车路径规划策略：（不走高速且躲避拥堵 : 6） Driving route planning strategy: (Avoid highways and congestion : 6)
    `static int` | `DRIVING_NO_HIGHWAY_AVOID_SHORT_MONEY` 驾车路径规划策略：（不走高速且避免收费 : 5） Driving route planning strategy: (Avoid highways and tolls : 5)
    `static int` | `DRIVING_NO_HIGHWAY_SAVE_MONEY_AVOID_CONGESTION` 驾车路径规划策略：（不走高速躲避收费和拥堵 : 8） Driving route planning strategy: (Avoid highways, tolls, and congestion : 8)
    `static int` | `DRIVING_SAVE_MONEY` 驾车路径规划策略：（费用优先 : 1） Driving route planning strategy: (Cost first : 1)
    `static int` | `DRIVING_SAVE_MONEY_AVOID_CONGESTION` 驾车路径规划策略：（躲避收费和拥堵 : 7） Driving route planning strategy: (Avoid tolls and congestion : 7)
    `static int` | `DRIVING_SHORT_DISTANCE` 驾车路径规划策略：（距离优先 : 2） Driving route planning strategy: (Distance first : 2)

  - ### 构造器概要

    构造器
    构造器和说明
    `AMapUtils()`

  - ### 方法概要

    所有方法 静态方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `static float` | `calculateArea(LatLng leftTopLatlng, LatLng rightBottomLatlng)` 计算地图上矩形区域的面积，单位平方米。
    `static float` | `calculateArea(java.util.List<LatLng> points)` 计算多边形的面积，单位平方米。
    `static float` | `calculateLineDistance(LatLng startLatlng, LatLng endLatlng)` 根据用户的起点和终点经纬度计算两点间距离，单位米。
    `static void` | `getLatestAMapApp(android.content.Context context)` 跳转到高德地图APP最新版本下载页面 Jump to the latest version download page of the AMap APP.
    `static void` | `openAMapDrivingRoute(RoutePara para, android.content.Context context)` 调起高德地图APP进行驾车路线规划。
    `static void` | `openAMapNavi(NaviPara para, android.content.Context context)` 调起高德地图APP进行导航。
    `static void` | `openAMapPoiNearbySearch(PoiPara para, android.content.Context context)` 调起高德地图APP进行poi周边检索。
    `static void` | `openAMapTransitRoute(RoutePara para, android.content.Context context)` 调起高德地图APP进行公交路线规划。
    `static void` | `openAMapWalkingRoute(RoutePara para, android.content.Context context)` 调起高德地图APP进行步行路线规划。

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

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

- - ### 字段详细资料

    - #### DRIVING_DEFAULT

          public static final int DRIVING_DEFAULT

      驾车路径规划策略：（速度优先 : 0）
      Driving route planning strategy: (Speed first : 0)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_SAVE_MONEY

          public static final int DRIVING_SAVE_MONEY

      驾车路径规划策略：（费用优先 : 1）
      Driving route planning strategy: (Cost first : 1)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_SHORT_DISTANCE

          public static final int DRIVING_SHORT_DISTANCE

      驾车路径规划策略：（距离优先 : 2）
      Driving route planning strategy: (Distance first : 2)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_NO_HIGHWAY

          public static final int DRIVING_NO_HIGHWAY

      驾车路径规划策略：（不走高速 : 3）
      Driving route planning strategy: (Avoid highways : 3)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_AVOID_CONGESTION

          public static final int DRIVING_AVOID_CONGESTION

      驾车路径规划策略：（避免拥堵 : 4）
      Driving route planning strategy: (Avoid congestion : 4)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_NO_HIGHWAY_AVOID_SHORT_MONEY

          public static final int DRIVING_NO_HIGHWAY_AVOID_SHORT_MONEY

      驾车路径规划策略：（不走高速且避免收费 : 5）
      Driving route planning strategy: (Avoid highways and tolls : 5)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_NO_HIGHWAY_AVOID_CONGESTION

          public static final int DRIVING_NO_HIGHWAY_AVOID_CONGESTION

      驾车路径规划策略：（不走高速且躲避拥堵 : 6）
      Driving route planning strategy: (Avoid highways and congestion : 6)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_SAVE_MONEY_AVOID_CONGESTION

          public static final int DRIVING_SAVE_MONEY_AVOID_CONGESTION

      驾车路径规划策略：（躲避收费和拥堵 : 7）
      Driving route planning strategy: (Avoid tolls and congestion : 7)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### DRIVING_NO_HIGHWAY_SAVE_MONEY_AVOID_CONGESTION

          public static final int DRIVING_NO_HIGHWAY_SAVE_MONEY_AVOID_CONGESTION

      驾车路径规划策略：（不走高速躲避收费和拥堵 : 8）
      Driving route planning strategy: (Avoid highways, tolls, and congestion : 8)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_TIME_FIRST

          public static final int BUS_TIME_FIRST

      公交路径规划策略：（最快捷 : 0）
      Bus route planning strategy: (Fastest : 0)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_MONEY_LITTLE

          public static final int BUS_MONEY_LITTLE

      公交路径规划策略：（费用优先 : 1）
      Bus route planning strategy: (Cost first : 1)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_TRANSFER_LITTLE

          public static final int BUS_TRANSFER_LITTLE

      公交路径规划策略：（最少换乘 : 2）
      Bus route planning strategy: (Least transfers : 2)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_WALK_LITTLE

          public static final int BUS_WALK_LITTLE

      公交路径规划策略：（最少步行 : 3）
      Bus route planning strategy: (Least walking : 3)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_COMFORT

          public static final int BUS_COMFORT

      公交路径规划策略：（最舒适 : 4）
      Bus route planning strategy: (Most comfortable : 4)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

    - #### BUS_NO_SUBWAY

          public static final int BUS_NO_SUBWAY

      公交路径规划策略：（不乘地铁 : 5）
      Bus route planning strategy: (Avoid subway : 5)
      从以下版本开始:
        2.4.1
      另请参阅:
        常量字段值

  - ### 构造器详细资料

    - #### AMapUtils

          public AMapUtils()

  - ### 方法详细资料

    - #### calculateLineDistance

          public static float calculateLineDistance(LatLng startLatlng,
                                                    LatLng endLatlng)

      根据用户的起点和终点经纬度计算两点间距离，单位米。
      Calculate the distance between two points based on the user's start and end latitude and longitude, in meters.
      参数:
        `startLatlng` - 起点的坐标。
        Coordinates of the starting point.
        `endLatlng` - 终点的坐标。
        Coordinates of the destination.
      返回:
        返回两点间的距离，单位米。
        Returns the distance between two points, in meters.
      从以下版本开始:
        2.0.2

    - #### calculateArea

          public static float calculateArea(LatLng leftTopLatlng,
                                            LatLng rightBottomLatlng)

      计算地图上矩形区域的面积，单位平方米。
      Calculate the area of a rectangular region on the map, in square meters.
      参数:
        `leftTopLatlng` - 矩形区域左上角坐标。
        Coordinates of the top-left corner of the rectangular region.
        `rightBottomLatlng` - 矩形区域右下角坐标。
        Coordinates of the bottom-right corner of the rectangular region.
      返回:
        返回地图上矩形区域的面积，单位平方米。
        Returns the area of the rectangular region on the map, in square meters.
      从以下版本开始:
        2.0.2

    - #### calculateArea

          public static float calculateArea(java.util.List<LatLng> points)

      计算多边形的面积，单位平方米。
      Calculate the area of a polygon, in square meters.
      参数:
        `points` - 多边形顶点坐标。
        Coordinates of the polygon vertices.
      返回:
        返回多边形的面积，单位平方米。
        Returns the area of the polygon, in square meters.
      从以下版本开始:
        6.0.0

    - #### getLatestAMapApp

          public static void getLatestAMapApp(android.content.Context context)

      跳转到高德地图APP最新版本下载页面
      Jump to the latest version download page of the AMap APP.
      参数:
        `context` - 上下文
      从以下版本开始:
        2.4.1

    - #### openAMapNavi

          public static void openAMapNavi(NaviPara para,
                                          android.content.Context context)
                                   throws AMapException

      调起高德地图APP进行导航。
      Invoke the AMap APP for navigation.
      参数:
        `para` - 导航需要的参数。
        Parameters required for navigation.
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        2.4.1

    - #### openAMapPoiNearbySearch

          public static void openAMapPoiNearbySearch(PoiPara para,
                                                     android.content.Context context)
                                              throws AMapException

      调起高德地图APP进行poi周边检索。
      Invoke the AMap APP for POI nearby search.
      参数:
        `para` - poi周边检索需要的参数。
        Parameters required for POI nearby search.
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        2.5.0

    - #### openAMapDrivingRoute

          public static void openAMapDrivingRoute(RoutePara para,
                                                  android.content.Context context)
                                           throws AMapException

      调起高德地图APP进行驾车路线规划。
      Invoke the AMap APP for driving route planning.
      参数:
        `para` - 驾车路线检索需要的参数。
        Parameters required for driving route search.
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        2.5.0

    - #### openAMapTransitRoute

          public static void openAMapTransitRoute(RoutePara para,
                                                  android.content.Context context)
                                           throws AMapException

      调起高德地图APP进行公交路线规划。
      Invoke the AMap APP for bus route planning.
      参数:
        `para` - 公交路线检索需要的参数。
        Parameters required for bus route search.
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        2.5.0

    - #### openAMapWalkingRoute

          public static void openAMapWalkingRoute(RoutePara para,
                                                  android.content.Context context)
                                           throws AMapException

      调起高德地图APP进行步行路线规划。
      Invoke the AMap APP for walking route planning.
      参数:
        `para` - 规划参数
        Planning parameters
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        2.5.0