您可以通过XML来配置地图的初始属性,也可以在代码中设置地图的初始属性并在之后动态更新其属性。
地图SDK为SupportMapFragment和MapView定义了一组自定义XML属性,您可以直接在布局文件中使用这些属性来配置地图的初始属性。
在使用这些属性之前,请确保您已经声明了下面的命名空间:
xmlns:map="http://schemas.android.com/apk/res-auto"
接下来,您就可以使用以下属性来配置地图的初始属性了:
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:id="@+id/mapfragment_mapfragmentdemo"
class="com.huawei.hms.maps.SupportMapFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:cameraBearing="45"
map:cameraMaxZoomPreference="13"
map:cameraMinZoomPreference="3"
map:cameraTargetLat="48.893478"
map:cameraTargetLng="2.334595"
map:cameraTilt="20"
map:cameraZoom="10"
map:latLngBoundsNorthEastLatitude="49.893478"
map:latLngBoundsNorthEastLongitude="1.334595"
map:latLngBoundsSouthWestLatitude="47.893478"
map:latLngBoundsSouthWestLongitude="3.334595"
map:liteMode="false"
map:mapType="normal"
map:uiCompass="true"
map:uiRotateGestures="false"
map:uiScrollGestures="true"
map:uiTiltGestures="true"
map:uiZoomControls="false"
map:uiZoomGestures="true"
map:useViewLifecycle="true"
map:zOrderOnTop="true"
map:dark="true" /> 您也可以通过代码方式设置地图的初始属性,并在需要更新相机状态时重新设置这些属性。所有在XML中设置的属性都可以在代码中设置。
“Java” // 声明SupportMapFragment SupportMapFragment mSupportMapFragment; // 初始化相机属性 CameraPosition cameraPosition = CameraPosition.builder().target(new LatLng(48.893478, 2.334595)).zoom(10).bearing(45).tilt(20).build(); // 构造相机目标区域 LatLng southwest = new LatLng(47.893478, 3.334595); LatLng northeast = new LatLng(49.893478, 1.334595); LatLngBounds latLngBounds = new LatLngBounds(southwest, northeast); HuaweiMapOptions options = new HuaweiMapOptions(); // 设置地图类型,有效值包括none、normal和terrain options.mapType(HuaweiMap.MAP_TYPE_NORMAL) // 设置相机属性 .camera(cameraPosition) // 设置缩放功能是否可用,默认可用 .zoomControlsEnabled(false) // 设置指南针是否可用,默认可用 .compassEnabled(true) // 设置缩放手势是否可用,默认可用 .zoomGesturesEnabled(true) // 设置滚动手势是否可用,默认可用 .scrollGesturesEnabled(true) // 设置旋转手势是否可用,默认可用 .rotateGesturesEnabled(false) // 设置倾斜手势是否可用,默认可用 .tiltGesturesEnabled(true) // 设置地图视图的表面是否放置在地图窗口的顶部,默认不放置在地图窗口的顶部 .zOrderOnTop(true) // 设置是否将地图的生命周期绑定到SupportMapFragment的视图上或SupportMapFragment本身,默认为true .useViewLifecycleInFragment(true) // 设置地图是否为精简模式。默认为否 .liteMode(false) // 设置偏好最小缩放级别 .minZoomPreference(3) // 设置偏好最大缩放级别 .maxZoomPreference(13) // 设置区域约束相机目标,使用户移动相机时,相机目标不会移出此边界范围 .latLngBoundsForCameraTarget(latLngBounds) // 设置是否开启深色模式 .dark(true); mSupportMapFragment = SupportMapFragment.newInstance(options);
“Kotlin” // 声明SupportMapFragment val mSupportMapFragment: SupportMapFragment // 初始化相机属性 val cameraPosition = CameraPosition.builder().target(LatLng(48.893478, 2.334595)).zoom(10f).bearing(45f).tilt(20f).build() // 构造相机目标区域 val southwest = LatLng(47.893478, 3.334595) val northeast = LatLng(49.893478, 1.334595) val latLngBounds = LatLngBounds(southwest, northeast) val options = HuaweiMapOptions() // 设置地图类型,有效值包括none、normal和terrain options.mapType(HuaweiMap.MAP_TYPE_NORMAL) // 设置相机属性 .camera(cameraPosition) // 设置缩放功能是否可用,默认可用 .zoomControlsEnabled(false) // 设置指南针是否可用,默认可用 .compassEnabled(true) // 设置缩放手势是否可用,默认可用 .zoomGesturesEnabled(true) // 设置滚动手势是否可用,默认可用 .scrollGesturesEnabled(true) // 设置旋转手势是否可用,默认可用 .rotateGesturesEnabled(false) // 设置倾斜手势是否可用,默认可用 .tiltGesturesEnabled(true) // 设置地图视图的表面是否放置在地图窗口的顶部,默认放置在地图窗口的顶部 .zOrderOnTop(true) // 设置是否将地图的生命周期绑定到SupportMapFragment的视图上或SupportMapFragment本身,默认为true .useViewLifecycleInFragment(true) // 设置地图是否为精简模式。默认为否 .liteMode(false) // 设置偏好最小缩放级别 .minZoomPreference(3f) // 设置偏好最大缩放级别 .maxZoomPreference(13f) // 设置区域约束相机目标,使用户移动相机时,相机目标不会移出此边界范围 .latLngBoundsForCameraTarget(latLngBounds) // 设置是否开启深色模式 .dark(true) mSupportMapFragment = SupportMapFragment.newInstance(options)
SupportMapFragment创建的时候,需要将其与Fragment的生命周期进行关联,即创建的时候需要使HuaweiMapOptions.useViewLifecycleInFragment(boolean isUseViewLifecycleInFragment)方法参数为true。