AMapUtils (mapslibrary API)

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()

构造器
构造器和说明
`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

类 AMapUtils

字段概要

构造器概要

方法概要

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

字段详细资料

DRIVING_DEFAULT

DRIVING_SAVE_MONEY

DRIVING_SHORT_DISTANCE

DRIVING_NO_HIGHWAY

DRIVING_AVOID_CONGESTION

DRIVING_NO_HIGHWAY_AVOID_SHORT_MONEY

DRIVING_NO_HIGHWAY_AVOID_CONGESTION

DRIVING_SAVE_MONEY_AVOID_CONGESTION

DRIVING_NO_HIGHWAY_SAVE_MONEY_AVOID_CONGESTION

BUS_TIME_FIRST

BUS_MONEY_LITTLE

BUS_TRANSFER_LITTLE

BUS_WALK_LITTLE

BUS_COMFORT

BUS_NO_SUBWAY

构造器详细资料

AMapUtils

方法详细资料

calculateLineDistance

calculateArea

calculateArea

getLatestAMapApp

openAMapNavi

openAMapPoiNearbySearch

openAMapDrivingRoute

openAMapTransitRoute

openAMapWalkingRoute