public final class AMap
extends java.lang.Object
限定符和类型 | 类和说明 |
---|---|
static interface |
AMap.CancelableCallback
在
AMap.animateCamera(CameraUpdate, CancelableCallback) 设置一个CancelableCallback,用来监听该CameraUpdate是否执行完成或者被中断。 |
static interface |
AMap.ImageInfoWindowAdapter
用来实现marker与对应InfoWindow同步移动
默认情况下,InfoWindow是一个View, 拖动地图的时候由于View 布局较慢,会有延迟的效果。 |
static interface |
AMap.InfoWindowAdapter
用来定制marker的信息窗口
默认情况下,当单击某个marker时,如果该marker的Title和Snippet不为空,则会触发getInfoWindow和getInfoContents回调。 |
static interface |
AMap.OnCacheRemoveListener
缓存数据清除监听接口
|
static interface |
AMap.OnCameraChangeListener
地图状态发生变化的监听接口。
|
static interface |
AMap.OnIndoorBuildingActiveListener
室内地图状态监听接口。
|
static interface |
AMap.OnInfoWindowClickListener
marker的信息窗口点击事件监听接口。
|
static interface |
AMap.OnMapClickListener
地图点击事件监听接口。
|
static interface |
AMap.OnMapLoadedListener
地图加载完成监听接口
|
static interface |
AMap.OnMapLongClickListener
地图长按事件监听接口。
|
static interface |
AMap.onMapPrintScreenListener
已过时。
|
static interface |
AMap.OnMapScreenShotListener
地图截屏监听接口 。
|
static interface |
AMap.OnMapTouchListener
地图触摸事件监听接口。
|
static interface |
AMap.OnMarkerClickListener
marker点击事件监听接口。
|
static interface |
AMap.OnMarkerDragListener
marker拖动事件监听接口。
|
static interface |
AMap.OnMultiPointClickListener
海量点中某一点被点击时的回调。
|
static interface |
AMap.OnMyLocationChangeListener
用户定位信息监听接口。
|
static interface |
AMap.OnPOIClickListener
地图底图poi点击事件监听接口。
|
static interface |
AMap.OnPolylineClickListener
polyline点击事件监听接口。
|
限定符和类型 | 字段和说明 |
---|---|
static int |
LOCATION_TYPE_LOCATE
已过时。
5.0.0 之后请参考
MyLocationStyle.LOCATION_TYPE_LOCATE |
static int |
LOCATION_TYPE_MAP_FOLLOW
已过时。
5.0.0 之后请参考
MyLocationStyle.LOCATION_TYPE_FOLLOW |
static int |
LOCATION_TYPE_MAP_ROTATE
已过时。
5.0.0 之后请参考
MyLocationStyle.LOCATION_TYPE_MAP_ROTATE |
static int |
MAP_TYPE_BUS
公交模式常量。
|
static int |
MAP_TYPE_NAVI
导航模式常量。
|
static int |
MAP_TYPE_NIGHT
夜景图模式常量。
|
static int |
MAP_TYPE_NORMAL
普通地图模式常量。
|
static int |
MAP_TYPE_SATELLITE
卫星图模式常量。
|
限定符和类型 | 方法和说明 |
---|---|
Arc |
addArc(ArcOptions options)
在地图上添加一个圆弧(arc)对象。
|
BuildingOverlay |
addBuildingOverlay()
添加建筑物图层,默认图层的区域为全世界。
|
Circle |
addCircle(CircleOptions options)
在地图上添加一个圆(circle)对象。
|
GroundOverlay |
addGroundOverlay(GroundOverlayOptions options)
在地图上添加一个Ground覆盖物(groundOverlay)对象
|
HeatMapLayer |
addHeatMapLayer(HeatMapLayerOptions options)
在地图上添加一个热力图对象。
|
Marker |
addMarker(MarkerOptions options)
在地图上添一个图片标记(marker)对象。
|
java.util.ArrayList<Marker> |
addMarkers(java.util.ArrayList<MarkerOptions> options,
boolean moveToCenter)
在地图上添一组图片标记(marker)对象,并设置是否改变地图状态以至于所有的marker对象都在当前地图可视区域范围内显示。
|
MultiPointOverlay |
addMultiPointOverlay(MultiPointOverlayOptions options)
在地图上添加一个海量点覆盖物(MultiPointOverlay)对象
|
NavigateArrow |
addNavigateArrow(NavigateArrowOptions options)
在地图上添加一个导航指示箭头对象(navigateArrow)对象。
|
ParticleOverlay |
addParticleOverlay(ParticleOverlayOptions options)
在地图上添加一个粒子系统对象
|
Polygon |
addPolygon(PolygonOptions options)
在地图上添加一个多边形(polygon)对象。
|
Polyline |
addPolyline(PolylineOptions options)
在地图上添加一个折线对象(polyline)对象。
|
Text |
addText(TextOptions options)
在地图上添一个文字标记(text)对象。
|
TileOverlay |
addTileOverlay(TileOverlayOptions options)
在地图上添加一个瓦片图层覆盖物(tileOverlay)对象。
|
void |
animateCamera(CameraUpdate update)
以动画方式按照传入的CameraUpdate参数更新地图状态,默认动画耗时250毫秒。
|
void |
animateCamera(CameraUpdate update,
AMap.CancelableCallback cancelableCallback)
以动画方式按照传入的CameraUpdate参数更新地图状态,默认动画耗时250毫秒,同时设置一个cancelableCallback来监听动画执行的结果。
|
void |
animateCamera(CameraUpdate update,
long durationMs,
AMap.CancelableCallback cancelableCallback)
按照指定的动画时长及传入的CameraUpdate参数更新地图状态,,同时设置一个cancelableCallback来监听动画执行的结果。
|
void |
clear()
从地图上删除所有的overlay(marker,circle,polyline 等对象)。
|
void |
clear(boolean isKeepMyLocationOverlay)
从地图上删除所有的覆盖物(marker,circle,polyline 等对象),但myLocationOverlay(内置定位覆盖物)除外。
|
CameraPosition |
getCameraPosition()
获取地图的当前状态。
|
java.lang.String |
getMapContentApprovalNumber()
获取地图审图号(普通地图)
任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号 如高德地图在"关于"中体现 |
void |
getMapPrintScreen(AMap.onMapPrintScreenListener listener)
|
java.util.List<Marker> |
getMapScreenMarkers()
获取当前地图可视区域范围所有marker对象。
|
void |
getMapScreenShot(AMap.OnMapScreenShotListener listener)
发起地图截屏请求。
|
int |
getMapTextZIndex()
得到地图底图文字标注的层级指数。
|
int |
getMapType()
获取地图当前的模式。
|
float |
getMaxZoomLevel()
返回地图可显示最大缩放级别。
|
float |
getMinZoomLevel()
返回地图可显示最小缩放级别。
|
Location |
getMyLocation()
返回当前定位源(locationSource)提供的定位信息。
|
MyLocationStyle |
getMyLocationStyle()
获取定位图层(myLocationOverlay)的样式。
|
MyTrafficStyle |
getMyTrafficStyle()
已过时。
自7.8.0之后不再支持
|
Projection |
getProjection()
获取地图投影坐标转换器, 当地图初始化完成之前返回 null。
|
java.lang.String |
getSatelliteImageApprovalNumber()
获取地图审图号(卫星地图)
任何使用高德地图API调用地图服务的应用必须在其应用中对外透出审图号 如高德地图在"关于"中体现 |
float |
getScalePerPixel()
获取当前缩放级别下,地图上1像素点对应的长度,单位米。
|
UiSettings |
getUiSettings()
获取地图ui控制器,可以控制内置ui(缩放按钮、指北针等)是否显示及部分手势(滑动、双指缩放等)是否可用。
|
static java.lang.String |
getVersion()
已过时。
|
boolean |
isMyLocationEnabled()
返回是否打开定位图层(myLocationOverlay)。
|
boolean |
isTouchPoiEnable()
获取地图POI是否允许点击。
|
boolean |
isTrafficEnabled()
获取是否打开交通路况图层。
|
void |
moveCamera(CameraUpdate update)
按照传入的CameraUpdate参数改变地图状态。
|
void |
reloadMap()
重新加载地图引擎,即调用此接口时会重新加载底图数据,覆盖物不受影响。
|
void |
removecache()
删除地图缓存。
|
void |
removecache(AMap.OnCacheRemoveListener onCacheRemoveListener)
删除地图缓存。
|
void |
resetMinMaxZoomPreference()
重置最小及最大缩放级别 将恢复最小级别为3,最大级别为20 。
|
void |
runOnDrawFrame()
触发地图立即刷新。
|
void |
setAMapGestureListener(AMapGestureListener aMapGestureListener)
设置手势监听接口
|
void |
setConstructingRoadEnable(boolean enabled)
设置在建道路图层是否显示,默认不显示。
|
void |
setCustomMapStyle(CustomMapStyleOptions options)
设置底图自定义样式对应配置文件路径。
|
void |
setCustomMapStyleID(java.lang.String styleID)
已过时。
该方法已无效,建议到官网lbs.amap.com更新样式文件并使用
AMap.setCustomMapStyle(CustomMapStyleOptions) )} 替换 |
void |
setCustomMapStylePath(java.lang.String stylePath)
已过时。
该方法已无效,建议到官网lbs.amap.com更新样式文件并使用
AMap.setCustomMapStyle(CustomMapStyleOptions) )} 替换 |
void |
setCustomRenderer(CustomRenderer render)
设置地图在初始化及每一帧绘制时的回调接口,该接口在OpenGL线程中调用。
|
void |
setIndoorBuildingInfo(IndoorBuildingInfo indoorBuildingInfo)
室内地图楼层控制接口,通过此接口可以控制某个室内地图显示的楼层。
|
void |
setInfoWindowAdapter(AMap.InfoWindowAdapter adapter)
设置marker的信息窗口定制接口。
|
void |
setLoadOfflineData(boolean enabled)
重新加载离线地图数据。
|
void |
setLocationSource(LocationSource locationSource)
设置定位源(locationSource)。
|
void |
setMapCustomEnable(boolean enable)
已过时。
该方法已无效,建议到官网lbs.amap.com更新样式文件并使用
AMap.setCustomMapStyle(CustomMapStyleOptions) )} 替换 |
void |
setMapStatusLimits(LatLngBounds latLngBounds)
设置地图显示范围,无论如何操作地图,显示区域都不能超过该矩形区域。
|
void |
setMapTextZIndex(int x)
设置地图底图文字标注的层级指数,默认为0,用来比较覆盖物(polyline、polygon、circle等)的zIndex。
|
void |
setMapType(int type)
设置地图模式。
|
void |
setMaxZoomLevel(float zoomLevel)
设置地图最大缩放级别 缩放级别范围为[3, 20],超出范围将按最大级别计算 。
|
void |
setMinZoomLevel(float zoomLevel)
设置最小缩放级别 缩放级别范围为[3, 20],超出范围将按最小级别计算
|
void |
setMyLocationEnabled(boolean enabled)
设置是否打开定位图层(myLocationOverlay)。
|
void |
setMyLocationRotateAngle(float rotate)
已过时。
自5.0.0 废弃
|
void |
setMyLocationStyle(MyLocationStyle style)
设置定位图层(myLocationOverlay)的样式。
|
void |
setMyLocationType(int type)
已过时。
5.0.0 之后请使用
AMap.setMyLocationStyle(MyLocationStyle) 代替 |
void |
setMyTrafficStyle(MyTrafficStyle style)
已过时。
自7.8.0之后不再支持
|
void |
setOnCameraChangeListener(AMap.OnCameraChangeListener listener)
设置地图状态的监听接口。
|
void |
setOnIndoorBuildingActiveListener(AMap.OnIndoorBuildingActiveListener listener)
设置室内地图状态监听接口
|
void |
setOnInfoWindowClickListener(AMap.OnInfoWindowClickListener listener)
设置marker的信息窗口点击事件监听接口。
|
void |
setOnMapClickListener(AMap.OnMapClickListener listener)
设置地图点击事件监听接口。
|
void |
setOnMapLoadedListener(AMap.OnMapLoadedListener listener)
设置地图加载完成监听接口
|
void |
setOnMapLongClickListener(AMap.OnMapLongClickListener listener)
设置地图长按事件监听接口。
|
void |
setOnMapTouchListener(AMap.OnMapTouchListener listener)
设置地图触摸事件监听接口。
|
void |
setOnMarkerClickListener(AMap.OnMarkerClickListener listener)
设置marker点击事件监听接口。
|
void |
setOnMarkerDragListener(AMap.OnMarkerDragListener listener)
marker拖动事件监听接口
|
void |
setOnMultiPointClickListener(AMap.OnMultiPointClickListener listener)
设置海量点单击事件监听
|
void |
setOnMyLocationChangeListener(AMap.OnMyLocationChangeListener listener)
设置用户定位信息监听接口。
|
void |
setOnPOIClickListener(AMap.OnPOIClickListener listener)
设置底图poi点击事件监听接口。
|
void |
setOnPolylineClickListener(AMap.OnPolylineClickListener listener)
设置polyline点击事件监听接口。
|
void |
setPointToCenter(int x,
int y)
设置屏幕上的某个像素点为地图中心点。
|
void |
setTouchPoiEnable(boolean touchPoiEnable)
设置地图POI是否允许点击。
|
void |
setTrafficEnabled(boolean enabled)
设置是否打开交通路况图层。
|
void |
showBuildings(boolean enabled)
设置是否显示3D建筑物,默认显示。
|
void |
showIndoorMap(boolean enabled)
设置是否显示室内地图,默认不显示。
|
void |
showMapText(boolean enabled)
设置是否显示底图文字标注,默认显示。
|
void |
stopAnimation()
停止当前执行的改变地图状态的动画。
|
public static final int MAP_TYPE_NORMAL
public static final int MAP_TYPE_SATELLITE
public static final int MAP_TYPE_NIGHT
public static final int MAP_TYPE_NAVI
public static final int MAP_TYPE_BUS
public static final int LOCATION_TYPE_LOCATE
MyLocationStyle.LOCATION_TYPE_LOCATE
public static final int LOCATION_TYPE_MAP_FOLLOW
MyLocationStyle.LOCATION_TYPE_FOLLOW
public static final int LOCATION_TYPE_MAP_ROTATE
MyLocationStyle.LOCATION_TYPE_MAP_ROTATE
public final CameraPosition getCameraPosition()
public final float getMaxZoomLevel()
public final float getMinZoomLevel()
public final void moveCamera(CameraUpdate update)
CameraUpdateFactory.zoomIn()
等方法来生成对应的CameraUpdate对象。update
- 地图状态将要发生的变化。public final void animateCamera(CameraUpdate update)
CameraUpdateFactory.zoomIn()
等方法来生成对应的CameraUpdate对象。update
- 地图状态将要发生的变化。public final void animateCamera(CameraUpdate update, AMap.CancelableCallback cancelableCallback)
CameraUpdateFactory.zoomIn()
等方法来生成对应的CameraUpdate对象。update
- 地图状态将要发生的变化。cancelableCallback
- 如果动画正常完成,则会回调onFinish()方法,被中断时回调onCancel()。public final void animateCamera(CameraUpdate update, long durationMs, AMap.CancelableCallback cancelableCallback)
CameraUpdateFactory.zoomIn()
等方法来生成对应的CameraUpdate对象。update
- 地图状态将要发生的变化。durationMs
- 动画的持续时间,单位毫秒。cancelableCallback
- 如果动画正常完成,则会回调onFinish()方法,被中断时回调onCancel()。public final void stopAnimation()
public final NavigateArrow addNavigateArrow(NavigateArrowOptions options)
options
- 一个navigateArrowOptions 对象,它定义navigateArrow的属性信息。public final Polyline addPolyline(PolylineOptions options)
options
- 一个polylineOptions对象,它定义polyline的属性信息。public final BuildingOverlay addBuildingOverlay()
public final Circle addCircle(CircleOptions options)
options
- 一个circleOptions对象,它定义circle的属性信息。public final Arc addArc(ArcOptions options)
options
- 一个arcOptions对象,它定义arc的属性信息。public final Polygon addPolygon(PolygonOptions options)
options
- 一个polygonOptions 对象,它定义了polygon的属性信息。public final GroundOverlay addGroundOverlay(GroundOverlayOptions options)
options
- 一个groundOverlayOptions 对象,它定义了groundOverlay 的属性信息。public final Marker addMarker(MarkerOptions options)
options
- 一个markerOptions 对象,它定义了marker 的属性信息。public final Text addText(TextOptions options)
options
- 一个textOptions 对象,它定义了text 的属性信息。public final java.util.ArrayList<Marker> addMarkers(java.util.ArrayList<MarkerOptions> options, boolean moveToCenter)
options
- 多个markerOptions对象,它们分别定义了对应marker的属性信息。moveToCenter
- 是否改变地图状态,默认为false。public final java.util.List<Marker> getMapScreenMarkers()
public final TileOverlay addTileOverlay(TileOverlayOptions options)
options
- 一个tileOverlayOptions 对象,它定义了tileOverlay的属性信息。public final HeatMapLayer addHeatMapLayer(HeatMapLayerOptions options)
options
- 一个HeatMapLayerOptions对象,它定义了heatMapLayer的属性信息。public MultiPointOverlay addMultiPointOverlay(MultiPointOverlayOptions options)
public ParticleOverlay addParticleOverlay(ParticleOverlayOptions options)
public final void clear()
public final void clear(boolean isKeepMyLocationOverlay)
isKeepMyLocationOverlay
- 是否保留myLocationOverlay。public final int getMapType()
public final void setMapType(int type)
type
- 地图模式: MAP_TYPE_NORMAL:普通地图,值为1;public final boolean isTrafficEnabled()
public void setTrafficEnabled(boolean enabled)
enabled
- 是否打开交通路况图层。public void showMapText(boolean enabled)
enabled
- true: 表示显示,为默认值; false: 不显示public void showIndoorMap(boolean enabled)
注:如果打开了室内地图,会显示3D建筑物,即如果之前有设置不显示3D建筑物,3D建筑物也会被显示出来。
enabled
- true:显示室内地图;false:不显示;public void showBuildings(boolean enabled)
enabled
- true:显示3D建筑物;false:不显示;public void setMyTrafficStyle(MyTrafficStyle style)
style
- MyTrafficStyle 包含各种路况对应的颜色,详细情况请参考MyTrafficStyle
。public MyTrafficStyle getMyTrafficStyle()
public final boolean isMyLocationEnabled()
public final void setMyLocationEnabled(boolean enabled)
enabled
- 是否打开定位图层。public final Location getMyLocation()
public final void setLocationSource(LocationSource locationSource)
locationSource
- 定位源(locationSource)。public final void setMyLocationStyle(MyLocationStyle style)
style
- myLocationStyle 定位图层(myLocationOverlay)样式。public final MyLocationStyle getMyLocationStyle()
public final void setMyLocationType(int type)
AMap.setMyLocationStyle(MyLocationStyle)
代替type
- 显示模式共有三种模式,参考:AMap.LOCATION_TYPE_LOCATE
普通、AMap.LOCATION_TYPE_MAP_FOLLOW
跟随、AMap.LOCATION_TYPE_MAP_ROTATE
旋转。public final void setMyLocationRotateAngle(float rotate)
rotate
- 旋转角度在0~360之间(从正北方向逆时针为正)。public final UiSettings getUiSettings()
public final Projection getProjection()
public final void setOnCameraChangeListener(AMap.OnCameraChangeListener listener)
listener
- 地图状态的监听接口。public final void setOnMapClickListener(AMap.OnMapClickListener listener)
listener
- 地图单击事件监听接口。public final void setOnMapTouchListener(AMap.OnMapTouchListener listener)
listener
- 地图触摸事件监听接口。public final void setOnPOIClickListener(AMap.OnPOIClickListener listener)
listener
- 底图poi点击事件监听接口。public final void setOnMyLocationChangeListener(AMap.OnMyLocationChangeListener listener)
listener
- 用户定位信息监听接口。public final void setOnMapLongClickListener(AMap.OnMapLongClickListener listener)
listener
- 地图长按事件监听接口。public final void setOnMarkerClickListener(AMap.OnMarkerClickListener listener)
listener
- marker点击事件监听接口。public final void setOnPolylineClickListener(AMap.OnPolylineClickListener listener)
listener
- polyline点击事件监听接口。public final void setOnMarkerDragListener(AMap.OnMarkerDragListener listener)
listener
- marker拖动事件监听接口。public final void setOnInfoWindowClickListener(AMap.OnInfoWindowClickListener listener)
listener
- marker的信息窗口点击事件监听接口。public final void setInfoWindowAdapter(AMap.InfoWindowAdapter adapter)
adapter
- marker的信息窗口定制接口。public final void setOnMapLoadedListener(AMap.OnMapLoadedListener listener)
listener
- 地图加载完成监听接口。public final void setOnIndoorBuildingActiveListener(AMap.OnIndoorBuildingActiveListener listener)
listener
- 室内地图状态监听接口。public void setOnMultiPointClickListener(AMap.OnMultiPointClickListener listener)
listener
- 海量点单击事件监听public void getMapPrintScreen(AMap.onMapPrintScreenListener listener)
listener
- 地图截屏监听接口。public void getMapScreenShot(AMap.OnMapScreenShotListener listener)
listener
- 地图截屏监听接口。public float getScalePerPixel()
public void runOnDrawFrame()
public void removecache()
AMap.removecache(OnCacheRemoveListener)
public void removecache(AMap.OnCacheRemoveListener onCacheRemoveListener)
onCacheRemoveListener
- 缓存数据清除监听接口。AMap.removecache()
public void setCustomRenderer(CustomRenderer render)
render
- 地图在初始化及每一帧绘制时的回调接口。public void setPointToCenter(int x, int y)
使用该方法设置后,地图将以所设置的屏幕坐标点为中心进行旋转、倾斜。同时, AMap.moveCamera(CameraUpdate)
方法也将会以此坐标点为中心进行设置。
x
- 屏幕像素点x轴坐标。y
- 屏幕像素点y轴坐标。public final void setMapTextZIndex(int x)
x
- 为地图底图文字标注的层级指数,默认为0。public final void setLoadOfflineData(boolean enabled)
下载完离线数据之后如果要直接显示,可以调用此接口先关闭再打开,从而达到重新加载地图数据的效果。
enabled
- true 打开地图数据库;false 关闭地图数据库。public final int getMapTextZIndex()
@Deprecated public static java.lang.String getVersion()
public void reloadMap()
public void setIndoorBuildingInfo(IndoorBuildingInfo indoorBuildingInfo)
indoorBuildingInfo
- indoorBuildingInfo 对象,它定义了室内地图属性,详情IndoorBuildingInfo
。public void setAMapGestureListener(AMapGestureListener aMapGestureListener)
aMapGestureListener
- 手势监听 详情见 AMapGestureListener
public void setMaxZoomLevel(float zoomLevel)
zoomLevel
- 最大缩放等级public void setMinZoomLevel(float zoomLevel)
zoomLevel
- 最小缩放等级public void resetMinMaxZoomPreference()
public void setMapStatusLimits(LatLngBounds latLngBounds)
latLngBounds
- 通过指定的两个经纬度坐标(左下、右上)构建的一个矩形区域,详情参见LatLngBounds
public void setMapCustomEnable(boolean enable)
AMap.setCustomMapStyle(CustomMapStyleOptions)
)} 替换enable
- 是否开启底图自定义样式。public void setCustomMapStylePath(java.lang.String stylePath)
AMap.setCustomMapStyle(CustomMapStyleOptions)
)} 替换stylePath
- 底图自定义样式对应配置文件路径。public void setCustomMapStyle(CustomMapStyleOptions options)
AMap.setCustomMapStyle(CustomMapStyleOptions)
中使用,请到官网(lbs.amap.com)更新新版样式文件options
- 底图自定义样式对应配置,包含样式文件、纹理路径等。public void setCustomMapStyleID(java.lang.String styleID)
AMap.setCustomMapStyle(CustomMapStyleOptions)
)} 替换styleID
- 样式idpublic java.lang.String getMapContentApprovalNumber()
public java.lang.String getSatelliteImageApprovalNumber()
public void setTouchPoiEnable(boolean touchPoiEnable)
touchPoiEnable
- true: 表示允许点击,为默认值; false: 不允许点击public boolean isTouchPoiEnable()
public void setConstructingRoadEnable(boolean enabled)
enabled
- true: 表示显示;false: 不显示,为默认值