AMap

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

public final class AMap
extends java.lang.Object

定义AMap 地图对象的操作方法与接口。

嵌套类概要

嵌套类
限定符和类型	类和说明
`static interface`	`AMap.InfoWindowAdapter` 用来定制marker的信息窗口默认情况下，当单击某个marker时，如果该marker的Title和Snippet不为空，则会触发getInfoWindow和getInfoContents回调。
`static interface`	`AMap.OnCameraChangeListener` 地图状态发生变化的监听接口。
`static interface`	`AMap.OnInfoWindowClickListener` marker的信息窗口点击事件监听接口。
`static interface`	`AMap.OnMapClickListener` 地图点击事件监听接口。
`static interface`	`AMap.OnMapLongClickListener` 地图长按事件监听接口。
`static interface`	`AMap.OnMapReadyListener` 地图加载完成监听接口
`static interface`	`AMap.OnMapTouchListener` 地图触摸事件监听接口。
`static interface`	`AMap.OnMarkerClickListener` marker点击事件监听接口。
`static interface`	`AMap.OnMarkerDragListener` marker拖动事件监听接口。
`static interface`	`AMap.OnMyLocationChangeListener` 用户定位信息监听接口。
`static interface`	`AMap.OnPolylineClickListener` polyline点击事件监听接口。

字段概要

字段
限定符和类型	字段和说明
`static int`	`MAP_TYPE_NIGHT` 夜景图模式常量。
`static int`	`MAP_TYPE_NORMAL` 普通地图模式常量。
`static int`	`MAP_TYPE_SATELLITE` 卫星图模式常量。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`Circle`	`addCircle(CircleOptions options)` 在地图上添加一个圆（circle）对象。
`Marker`	`addMarker(MarkerOptions options)` 在地图上添一个图片标记（marker）对象。
`java.util.ArrayList<Marker>`	`addMarkers(java.util.ArrayList<MarkerOptions> options, boolean moveToCenter)` 在地图上添一组图片标记（marker）对象，并设置是否改变地图状态以至于所有的marker对象都在当前地图可视区域范围内显示。
`Polygon`	`addPolygon(PolygonOptions options)` 在地图上添加一个多边形（polygon）对象。
`Polyline`	`addPolyline(PolylineOptions options)` 在地图上添加一个折线对象（polyline）对象。
`void`	`animateCamera(CameraUpdate update)` 以动画方式按照传入的CameraUpdate参数更新地图状态，默认动画耗时250毫秒。
`void`	`clear()` 从地图上删除所有的overlay（marker，circle，polyline 等对象）。
`void`	`clear(boolean isKeepMyLocationOverlay)` 从地图上删除所有的覆盖物（marker，circle，polyline 等对象），但myLocationOverlay（内置定位覆盖物）除外。
`CameraPosition`	`getCameraPosition()` 获取地图的当前状态。
`java.lang.String`	`getMapContentApprovalNumber()` 获取地图审图号（普通地图）任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号如高德地图在"关于"中体现
`int`	`getMapType()` 获取地图当前的模式。
`float`	`getMaxZoomLevel()` 返回地图可显示最大缩放级别。
`float`	`getMinZoomLevel()` 返回地图可显示最小缩放级别。
`Location`	`getMyLocation()` 返回当前定位源（locationSource）提供的定位信息。
`MyLocationStyle`	`getMyLocationStyle()` 获取定位图层（myLocationOverlay）的样式。
`Projection`	`getProjection()` 获取地图投影坐标转换器, 当地图初始化完成之前返回 null。
`java.lang.String`	`getSatelliteImageApprovalNumber()` 获取地图审图号（卫星地图）任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号如高德地图在"关于"中体现
`UiSettings`	`getUiSettings()` 获取地图ui控制器，可以控制内置ui（缩放按钮、指北针等）是否显示及部分手势（滑动、双指缩放等）是否可用。
`void`	`moveCamera(CameraUpdate update)` 按照传入的CameraUpdate参数改变地图状态。
`void`	`setInfoWindowAdapter(AMap.InfoWindowAdapter adapter)` 设置marker的信息窗口定制接口。
`void`	`setLocationSource(LocationSource locationSource)` 设置定位源（locationSource）。
`void`	`setMapStatusLimits(LatLngBounds latLngBounds)` 设置地图显示范围，无论如何操作地图，显示区域都不能超过该矩形区域。
`void`	`setMapType(int type)` 设置地图模式。
`void`	`setMaxZoomLevel(float zoomLevel)` 设置地图最大缩放级别缩放级别范围为[3, 20],超出范围将按最大级别计算。
`void`	`setMinZoomLevel(float zoomLevel)` 设置最小缩放级别缩放级别范围为[3, 20],超出范围将按最小级别计算
`void`	`setMyLocationEnabled(boolean enabled)` 设置是否打开定位图层（myLocationOverlay）。
`void`	`setMyLocationStyle(MyLocationStyle style)` 设置定位图层（myLocationOverlay）的样式。
`void`	`setOnCameraChangeListener(AMap.OnCameraChangeListener listener)` 设置地图状态的监听接口。
`void`	`setOnInfoWindowClickListener(AMap.OnInfoWindowClickListener listener)` 设置marker的信息窗口点击事件监听接口。
`void`	`setOnMapClickListener(AMap.OnMapClickListener listener)` 设置地图点击事件监听接口。
`void`	`setOnMapLongClickListener(AMap.OnMapLongClickListener listener)` 设置地图长按事件监听接口。
`void`	`setOnMapTouchListener(AMap.OnMapTouchListener listener)` 设置地图触摸事件监听接口。
`void`	`setOnMarkerClickListener(AMap.OnMarkerClickListener listener)` 设置marker点击事件监听接口。
`void`	`setOnMarkerDragListener(AMap.OnMarkerDragListener listener)` marker拖动事件监听接口
`void`	`setOnMyLocationChangeListener(AMap.OnMyLocationChangeListener listener)` 设置用户定位信息监听接口。
`void`	`setOnPolylineClickListener(AMap.OnPolylineClickListener listener)` 设置polyline点击事件监听接口。
`void`	`setTrafficEnabled(boolean enabled)` 设置是否打开交通路况图层。
`void`	`showBuildings(boolean enabled)` 设置是否显示3D建筑物，默认显示。
`void`	`showMapText(boolean enabled)` 设置是否显示底图文字标注，默认显示。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - MAP_TYPE_NORMAL
```
public static final int MAP_TYPE_NORMAL
```
    普通地图模式常量。
    
    从以下版本开始:
    
    1.0.0
    
    另请参阅:
    
    常量字段值
  - MAP_TYPE_SATELLITE
```
public static final int MAP_TYPE_SATELLITE
```
    卫星图模式常量。
    
    从以下版本开始:
    
    1.0.0
    
    另请参阅:
    
    常量字段值
  - MAP_TYPE_NIGHT
```
public static final int MAP_TYPE_NIGHT
```
    夜景图模式常量。
    
    从以下版本开始:
    
    1.0.0
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - moveCamera
```
public final void moveCamera(CameraUpdate update)
```
    按照传入的CameraUpdate参数改变地图状态。（直接改变状态，没有动画效果）
    可以通过CameraUpdateFactory.zoomIn()等方法来生成对应的CameraUpdate对象。
    
    参数:
    
    update - 地图状态将要发生的变化。
    
    从以下版本开始:
    
    1.0.0
  - animateCamera
```
public final void animateCamera(CameraUpdate update)
```
    以动画方式按照传入的CameraUpdate参数更新地图状态，默认动画耗时250毫秒。
    可以通过CameraUpdateFactory.zoomIn()等方法来生成对应的CameraUpdate对象。
    
    参数:
    
    update - 地图状态将要发生的变化。
    
    从以下版本开始:
    
    1.0.0
  - addPolyline
```
public final Polyline addPolyline(PolylineOptions options)
```
    在地图上添加一个折线对象（polyline）对象。
    
    参数:
    
    options - 一个polylineOptions对象，它定义polyline的属性信息。
    
    返回:
    
    返回被添加的 polyline 对象。
    
    从以下版本开始:
    
    1.0.0
  - addPolygon
```
public final Polygon addPolygon(PolygonOptions options)
```
    在地图上添加一个多边形（polygon）对象。
    
    参数:
    
    options - 一个polygonOptions 对象，它定义了polygon的属性信息。
    
    返回:
    
    返回被添加的polygon对象。
    
    从以下版本开始:
    
    1.0.0
  - addCircle
```
public final Circle addCircle(CircleOptions options)
```
    在地图上添加一个圆（circle）对象。
    
    参数:
    
    options - 一个circleOptions对象，它定义circle的属性信息。
    
    返回:
    
    返回被添加的circle 对象。
    
    从以下版本开始:
    
    1.0.0
  - addMarker
```
public final Marker addMarker(MarkerOptions options)
```
    在地图上添一个图片标记（marker）对象。
    
    参数:
    
    options - 一个markerOptions 对象，它定义了marker 的属性信息。
    
    返回:
    
    返回被添加的marker对象。
    
    从以下版本开始:
    
    1.0.0
  - addMarkers
```
public final java.util.ArrayList<Marker> addMarkers(java.util.ArrayList<MarkerOptions> options,
                                                    boolean moveToCenter)
```
    在地图上添一组图片标记（marker）对象，并设置是否改变地图状态以至于所有的marker对象都在当前地图可视区域范围内显示。
    
    参数:
    
    options - 多个markerOptions对象，它们分别定义了对应marker的属性信息。
    
    moveToCenter - 是否改变地图状态，默认为false。
    
    返回:
    
    返回一组被添加的marker对象。
    
    从以下版本开始:
    
    1.0.0
  - clear
```
public final void clear()
```
    从地图上删除所有的overlay（marker，circle，polyline 等对象）。
    
    从以下版本开始:
    
    1.0.0
  - clear
```
public final void clear(boolean isKeepMyLocationOverlay)
```
    从地图上删除所有的覆盖物（marker，circle，polyline 等对象），但myLocationOverlay（内置定位覆盖物）除外。
    
    参数:
    
    isKeepMyLocationOverlay - 是否保留myLocationOverlay。
    
    从以下版本开始:
    
    1.0.0
  - setOnMyLocationChangeListener
```
public final void setOnMyLocationChangeListener(AMap.OnMyLocationChangeListener listener)
```
    设置用户定位信息监听接口。
    
    参数:
    
    listener - 用户定位信息监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnMarkerDragListener
```
public final void setOnMarkerDragListener(AMap.OnMarkerDragListener listener)
```
    marker拖动事件监听接口
    
    参数:
    
    listener - marker拖动事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnInfoWindowClickListener
```
public final void setOnInfoWindowClickListener(AMap.OnInfoWindowClickListener listener)
```
    设置marker的信息窗口点击事件监听接口。
    
    参数:
    
    listener - marker的信息窗口点击事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnMarkerClickListener
```
public final void setOnMarkerClickListener(AMap.OnMarkerClickListener listener)
```
    设置marker点击事件监听接口。
    
    参数:
    
    listener - marker点击事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnPolylineClickListener
```
public final void setOnPolylineClickListener(AMap.OnPolylineClickListener listener)
```
    设置polyline点击事件监听接口。
    
    参数:
    
    listener - polyline点击事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnCameraChangeListener
```
public final void setOnCameraChangeListener(AMap.OnCameraChangeListener listener)
```
    设置地图状态的监听接口。
    
    参数:
    
    listener - 地图状态的监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnMapClickListener
```
public final void setOnMapClickListener(AMap.OnMapClickListener listener)
```
    设置地图点击事件监听接口。
    
    参数:
    
    listener - 地图单击事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnMapLongClickListener
```
public final void setOnMapLongClickListener(AMap.OnMapLongClickListener listener)
```
    设置地图长按事件监听接口。
    
    参数:
    
    listener - 地图长按事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setOnMapTouchListener
```
public final void setOnMapTouchListener(AMap.OnMapTouchListener listener)
```
    设置地图触摸事件监听接口。
    
    参数:
    
    listener - 地图触摸事件监听接口。
    
    从以下版本开始:
    
    1.0.0
  - setInfoWindowAdapter
```
public final void setInfoWindowAdapter(AMap.InfoWindowAdapter adapter)
```
    设置marker的信息窗口定制接口。
    
    参数:
    
    adapter - marker的信息窗口定制接口。
    
    从以下版本开始:
    
    1.0.0
  - setMapType
```
public final void setMapType(int type)
```
    设置地图模式。
    
    参数:
    
    type - 地图模式： MAP_TYPE_NORMAL：普通地图，值为1；
    MAP_TYPE_SATELLITE：卫星地图，值为2；
    MAP_TYPE_NIGHT 黑夜地图，夜间模式，值为3；
    
    从以下版本开始:
    
    1.0.0
  - getMapType
```
public final int getMapType()
```
    获取地图当前的模式。可以参考AMap.MAP_TYPE_NORMAL、AMap.MAP_TYPE_SATELLITE 等。
    
    返回:
    
    地图当前的模式。
    
    从以下版本开始:
    
    1.0.0
  - getMyLocationStyle
```
public final MyLocationStyle getMyLocationStyle()
```
    获取定位图层（myLocationOverlay）的样式。
    
    返回:
    
    myLocationStyle 定位图层（myLocationOverlay）样式。
    
    从以下版本开始:
    
    1.0.0
  - getMyLocation
```
public final Location getMyLocation()
```
    返回当前定位源（locationSource）提供的定位信息。如果未设置定位源（locationSource）则返回null。
    
    返回:
    
    当前定位源（locationSource）提供的定位信息。
    
    从以下版本开始:
    
    1.0.0
  - getCameraPosition
```
public final CameraPosition getCameraPosition()
```
    获取地图的当前状态。
    
    返回:
    
    一个cameraPosition对象，表示地图的当前状态。
    
    从以下版本开始:
    
    1.0.0
  - setLocationSource
```
public final void setLocationSource(LocationSource locationSource)
```
    设置定位源（locationSource）。
    
    参数:
    
    locationSource - 定位源（locationSource）。
    
    从以下版本开始:
    
    1.0.0
  - setMyLocationEnabled
```
public final void setMyLocationEnabled(boolean enabled)
```
    设置是否打开定位图层（myLocationOverlay）。
    
    参数:
    
    enabled - 是否打开定位图层。
    
    从以下版本开始:
    
    1.0.0
  - setMyLocationStyle
```
public final void setMyLocationStyle(MyLocationStyle style)
```
    设置定位图层（myLocationOverlay）的样式。
    
    参数:
    
    style - myLocationStyle 定位图层（myLocationOverlay）样式。
    
    从以下版本开始:
    
    1.0.0
  - setMaxZoomLevel
```
public void setMaxZoomLevel(float zoomLevel)
```
    设置地图最大缩放级别缩放级别范围为[3, 20],超出范围将按最大级别计算。注：只有在有室内地图显示的情况下最大级别为20，否则最大级别为19。
    
    参数:
    
    zoomLevel - 最大缩放等级
    
    从以下版本开始:
    
    1.0.0
  - setMinZoomLevel
```
public void setMinZoomLevel(float zoomLevel)
```
    设置最小缩放级别缩放级别范围为[3, 20],超出范围将按最小级别计算
    
    参数:
    
    zoomLevel - 最小缩放等级
    
    从以下版本开始:
    
    1.0.0
  - getMaxZoomLevel
```
public final float getMaxZoomLevel()
```
    返回地图可显示最大缩放级别。
    
    返回:
    
    最大缩放级别。
    
    从以下版本开始:
    
    1.0.0
  - getMinZoomLevel
```
public final float getMinZoomLevel()
```
    返回地图可显示最小缩放级别。
    
    返回:
    
    最小缩放级别。
    
    从以下版本开始:
    
    1.0.0
  - setMapStatusLimits
```
public void setMapStatusLimits(LatLngBounds latLngBounds)
```
    设置地图显示范围，无论如何操作地图，显示区域都不能超过该矩形区域。
    
    参数:
    
    latLngBounds - 通过指定的两个经纬度坐标（左下、右上）构建的一个矩形区域，详情参见LatLngBounds
    
    从以下版本开始:
    
    1.0.0
  - setTrafficEnabled
```
public void setTrafficEnabled(boolean enabled)
```
    设置是否打开交通路况图层。
    
    参数:
    
    enabled - 是否打开交通路况图层。
    
    从以下版本开始:
    
    1.0.0
  - showMapText
```
public void showMapText(boolean enabled)
```
    设置是否显示底图文字标注，默认显示。
    
    参数:
    
    enabled - true：表示显示，为默认值； false：不显示
    
    从以下版本开始:
    
    1.0.0
  - showBuildings
```
public void showBuildings(boolean enabled)
```
    设置是否显示3D建筑物，默认显示。
    注：
    1. 开启显示3D建筑物后，地图需要被放大至Zoomlevel 17级以上且地图仰角>0（在地图上双指下滑可以调为仰视视角）时，才能可以看到3D建筑物的效果。
    2. 夜间模式的地图无3D建筑物效果。
    
    参数:
    
    enabled - true：显示3D建筑物；false：不显示；
    
    从以下版本开始:
    
    1.0.0
  - getUiSettings
```
public final UiSettings getUiSettings()
```
    获取地图ui控制器，可以控制内置ui（缩放按钮、指北针等）是否显示及部分手势（滑动、双指缩放等）是否可用。
    
    返回:
    
    地图ui控制器。
    
    从以下版本开始:
    
    1.0.0
  - getProjection
```
public final Projection getProjection()
```
    获取地图投影坐标转换器, 当地图初始化完成之前返回 null。
    
    返回:
    
    地图投影坐标转换器。
    
    从以下版本开始:
    
    1.0.0
  - getMapContentApprovalNumber
```
public java.lang.String getMapContentApprovalNumber()
```
    获取地图审图号（普通地图）
    任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号
    如高德地图在"关于"中体现
    
    返回:
    
    普通矢量地图审图号
    
    从以下版本开始:
    
    1.0.0
  - getSatelliteImageApprovalNumber
```
public java.lang.String getSatelliteImageApprovalNumber()
```
    获取地图审图号（卫星地图）
    任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号
    如高德地图在"关于"中体现
    
    返回:
    
    卫星地图审图号
    
    从以下版本开始:
    
    1.0.0

类 AMap

嵌套类概要

字段概要

方法概要

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

字段详细资料

MAP_TYPE_NORMAL

MAP_TYPE_SATELLITE

MAP_TYPE_NIGHT

方法详细资料

moveCamera

animateCamera

addPolyline

addPolygon

addCircle

addMarker

addMarkers

clear

clear

setOnMyLocationChangeListener

setOnMarkerDragListener

setOnInfoWindowClickListener

setOnMarkerClickListener

setOnPolylineClickListener

setOnCameraChangeListener

setOnMapClickListener

setOnMapLongClickListener

setOnMapTouchListener

setInfoWindowAdapter

setMapType

getMapType

getMyLocationStyle

getMyLocation

getCameraPosition

setLocationSource

setMyLocationEnabled

setMyLocationStyle

setMaxZoomLevel

setMinZoomLevel

getMaxZoomLevel

getMinZoomLevel

setMapStatusLimits

setTrafficEnabled

showMapText

showBuildings

getUiSettings

getProjection

getMapContentApprovalNumber

getSatelliteImageApprovalNumber