HuaweiMap的地图控制器。
方法 | 返回类型 | 描述 |
|---|---|---|
Future<void> | 清除瓦片图层的缓存。 | |
Future<void> | 启动标记动画。 | |
Future<void> | 以动画模式更新相机位置。 | |
Future<void> | 停止相机的当前动画。调用此方法时,相机立即停止移动并停留在当前位置。 | |
Future<void> | 更新相机位置。相机移动是瞬时完成的。 | |
Future<void> | 设置地图样式。 | |
Future<void> | 设置位置源的位置。 | |
Future<void> | 设置“我的位置”图层的位置源。 | |
Future<void> | 去激活位置源。 | |
Future<LatLngBounds> | 获取屏幕坐标与经纬度坐标转换后的可见区域。 | |
Future<ScreenCoordinate> | 获取指定经纬度坐标对应的屏幕位置。屏幕上的位置以相对于地图左上角(而不是屏幕左上角)的屏幕像素(而不是显示像素)来指定。 | |
Future<LatLng> | 获取屏幕上位置的经纬度。屏幕上的位置以相对于地图左上角(而不是屏幕左上角)的屏幕像素(而不是显示像素)来指定。 | |
Future<void> | 显示标记的信息窗。 | |
Future<void> | 隐藏标记的信息窗。该方法对于不可见的标记无效。 | |
Future<bool?> | 检查当前是否显示了标记的信息窗。此方法不会考虑信息窗是否在屏幕上实际可见。 | |
Future<bool?> | 检查标记是否可以聚合。 | |
Future<double?> | 获取地图的缩放级别。 | |
Future<Uint8List?> | 拍摄地图的快照。 |
清除瓦片图层的缓存。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
tileOverlay | TileOverlay对象。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和TileOverlay。 HuaweiMapController mapController; TileOverlay tileOverlay; // 调用clearTileCache接口。 await mapController.clearTileCache(tileOverlay);
启动标记动画。该方法是异步的。
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和一个带有动画的Marker对象。 HuaweiMapController mapController; Marker marker; // 调用startAnimationOnMarker接口。 await mapController.startAnimationOnMarker(marker!);
以动画模式更新相机位置。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
cameraUpdate | 相机位置变更。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和CameraUpdate对象。 HuaweiMapController mapController; CameraUpdate cameraUpdate; // 调用animateCamera接口。 await mapController.animateCamera(cameraUpdate);
停止相机的当前动画。调用此方法时,相机立即停止移动并停留在当前位置。
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController。 HuaweiMapController mapController; // 调用stopAnimation接口。 await mapController.stopAnimation();
以瞬时模式更新相机位置。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
cameraUpdate | 相机位置变更。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和CameraUpdate对象。 HuaweiMapController mapController; CameraUpdate cameraUpdate; // 调用moveCamera接口。 await mapController.moveCamera(cameraUpdate);
设置地图样式。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
mapStyle | String | 地图样式的JSON字符串。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController。
HuaweiMapController mapController;
// 调用setMapStyle接口。
await mapController.setMapStyle("YOUR_MAP_STYLE_AS_JSON"); 设置位置源的位置。
参数 | 类型 | 描述 |
|---|---|---|
latLng | 偏好位置。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController。 HuaweiMapController mapController; // 调用setLocation接口。 await mapController.setLocation(latLng);
设置“我的位置”图层的位置源。
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController。 HuaweiMapController mapController; // 调用setLocationSource接口。 await mapController.setLocationSource();
去激活位置源。
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController。 HuaweiMapController mapController; // 调用deactivateLocationSource接口。 await mapController.deactivateLocationSource();
获取屏幕坐标与经纬度坐标转换后的可见区域。该方法是异步的。
返回类型 | 描述 |
|---|---|
Future<LatLngBounds> | 包含可见区域的最小边界框。 |
调用示例:
// 定义HuaweiMapController。 HuaweiMapController mapController; // 调用getVisibleRegion接口。 LatLngBounds bounds = await mapController.getVisibleRegion();
获取指定经纬度坐标对应的屏幕位置。屏幕上的位置以相对于地图左上角(而不是屏幕左上角)的屏幕像素(而不是显示像素)来指定。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
latLng | 地图上位置的经纬度。 |
返回类型 | 描述 |
|---|---|
Future<ScreenCoordinate> | 位置在屏幕上的坐标,单位为像素。 |
调用示例:
// 定义HuaweiMapController和LatLng对象。 HuaweiMapController mapController; LatLng latLng; // 调用getScreenCoordinate接口。 ScreenCoordinate coordinate = await mapController.getScreenCoordinate(latLng);
获取屏幕上位置的经纬度。屏幕上的位置以相对于地图左上角(而不是屏幕左上角)的屏幕像素(而不是显示像素)来指定。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
screenCoordinate | 位置在屏幕上的坐标,单位为像素。 |
调用示例:
// 定义HuaweiMapController和ScreenCoordinate对象。 HuaweiMapController mapController; ScreenCoordinate screenCoordinate; // 调用getLatLng接口。 LatLng latLng = await mapController.getLatLng(screenCoordinate);
显示标记的信息窗。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
markerId | 标记ID。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和一个带有信息窗的Marker对象。 HuaweiMapController mapController; Marker marker; // 调用showMarkerInfoWindow接口。 await mapController.showMarkerInfoWindow(marker.markerId);
隐藏标记的信息窗。此方法是异步的,且对于不可见标记无效。
参数 | 类型 | 描述 |
|---|---|---|
markerId | 标记ID。 |
返回类型 | 描述 |
|---|---|
Future<void> | 无返回值的执行任务的Future结果。 |
调用示例:
// 定义HuaweiMapController和一个带有信息窗的Marker对象。 HuaweiMapController mapController; Marker marker; // 调用hideMarkerInfoWindow接口。 await mapController.hideMarkerInfoWindow(marker.markerId);
检查当前是否显示标记的信息窗。此方法是异步的,且不会考虑信息窗是否在屏幕上实际可见。
参数 | 类型 | 描述 |
|---|---|---|
markerId | 标记ID。 |
返回类型 | 描述 |
|---|---|
Future<bool?> | 如果当前显示标记的信息窗,则返回true;否则返回false。 |
调用示例:
// 定义HuaweiMapController和一个带有信息窗的Marker对象。 HuaweiMapController mapController; Marker marker; // 调用isMarkerInfoWindowShown接口。 bool? status = await mapController.isMarkerInfoWindowShown(marker.markerId);
检查标记是否可以聚合。该方法是异步的。
参数 | 类型 | 描述 |
|---|---|---|
markerId | 标记ID。 |
返回类型 | 描述 |
|---|---|
Future<bool?> | 如果标记可以聚合,则返回true;否则返回false。 |
调用示例:
// 定义HuaweiMapController和一个带有clusterable特性的Marker对象。 HuaweiMapController mapController; Marker marker; // 调用isMarkerClusterable接口。 bool? isClusterable = await mapController.isMarkerClusterable(marker.markerId);