相机包含以下4个属性:
| 属性 | 描述 |
|---|---|
| target | 地图中心位置的经纬度坐标。 |
| bearing | 地图以正北方向为0度顺时针旋转的角度。 |
| tilt | 相机的倾斜角度,即相机角度与垂直于地球表面直线的夹角。 |
| zoom | 屏幕中心附近的缩放级别。 |
地图的移动是通过模拟相机移动的方式实现的,您可以通过改变相机位置,来控制地图的可见区域。您要更改相机位置时,可以通过CameraUpdateFactory创建不同类型的CameraUpdate,然后再去移动相机。
“Java” // 方式1:相机放大级数加1,保持其他属性不变 CameraUpdate cameraUpdate = CameraUpdateFactory.zoomIn(); // 方式2:相机放大级数减1,保持其他属性不变 CameraUpdate cameraUpdate1 = CameraUpdateFactory.zoomOut(); // 方式3:指定相机缩放级数zoom值,其他属性不变 float zoom = 8.0f; CameraUpdate cameraUpdate2 = CameraUpdateFactory.zoomTo(zoom); // 方式4:指定相机缩放级别增量amount,您调用此方法可以在原来相机的缩放级别之上,进行适当的缩放 float amount = 2.0f; CameraUpdate cameraUpdate3 = CameraUpdateFactory.zoomBy(amount); // 方式5:指定缩放级别增量和一个中心点,您调用此API可以移动相机至中心点位置,并进行缩放 // 屏幕坐标点 Point point = new Point(31, 118); float amount = 2.0f; CameraUpdate cameraUpdate4 = CameraUpdateFactory.zoomBy(amount, point); // 方式6:设置相机的经纬度,其他参数不变 LatLng latLng1 = new LatLng(31.5, 118.9); CameraUpdate cameraUpdate5 = CameraUpdateFactory.newLatLng(latLng1); // 方式7:设置相机的可见区域,和到边界的距离 int padding = 100; LatLng latLng1 = new LatLng(31.5, 118.9); LatLng latLng2 = new LatLng(32.5, 119.9); LatLngBounds latLngBounds = new LatLngBounds(latLng1, latLng2); CameraUpdate cameraUpdate6 = CameraUpdateFactory.newLatLngBounds(latLngBounds, padding); // 方式8:设置相机的中心点位置和缩放级数 float zoom = 0.0f; LatLng latLng2 = new LatLng(32.5, 119.9); CameraUpdate cameraUpdate7 = CameraUpdateFactory.newLatLngZoom(latLng2, zoom); // 方式9:滚动相机,将相机按照指定的像素点移动 float x = 100.0f; float y = 100.0f; CameraUpdate cameraUpdate8 = CameraUpdateFactory.scrollBy(x, y); // 方式10:指定相机位置 // 倾斜度 float tilt = 2.2f; // 方向 float bearing = 31.5f; CameraPosition cameraPosition = new CameraPosition(latLng1,zoom,tilt,bearing); CameraUpdate cameraUpdate9 = CameraUpdateFactory.newCameraPosition(cameraPosition);
“Kotlin” // 方式1:相机放大级数加1,保持其他属性不变 val cameraUpdate = CameraUpdateFactory.zoomIn() // 方式2:相机放大级数减1,保持其他属性不变 val cameraUpdate1 = CameraUpdateFactory.zoomOut() // 方式3:指定相机缩放级数zoom值,其他属性不变 val zoom = 8.0f val cameraUpdate2 = CameraUpdateFactory.zoomTo(zoom) // 方式4:指定相机缩放级别增量amount,您调用此方法可以在原来相机的缩放级别之上,进行适当的缩放 val amount = 2.0f val cameraUpdate3 = CameraUpdateFactory.zoomBy(amount) // 方式5:指定缩放级别增量和一个中心点,您调用此API可以移动相机至中心点位置,并进行缩放 // 屏幕坐标点 val point = Point(31, 118) val amount = 2.0f val cameraUpdate4 = CameraUpdateFactory.zoomBy(amount, point) // 方式6:设置相机的经纬度,其他参数不变 val latLng1 = LatLng(31.5, 118.9) val cameraUpdate5 = CameraUpdateFactory.newLatLng(latLng1) // 方式7:设置相机的可见区域,和到边界的距离 val padding = 100 val latLng1 = LatLng(31.5, 118.9) val latLng2 = LatLng(32.5, 119.9) val latLngBounds = LatLngBounds(latLng1, latLng2) val cameraUpdate6 = CameraUpdateFactory.newLatLngBounds(latLngBounds, padding) // 方式8:设置相机的中心点位置和缩放级数 val zoom = 0.0f val latLng2 = LatLng(32.5, 119.9) val cameraUpdate7 = CameraUpdateFactory.newLatLngZoom(latLng2, zoom) // 方式9:滚动相机,将相机按照指定的像素点移动 val x = 100.0f val y = 100.0f val cameraUpdate8 = CameraUpdateFactory.scrollBy(x, y) // 方式10:指定相机位置 // 倾斜度 val tilt = 2.2f // 方向 val bearing = 31.5f val cameraPosition = CameraPosition(latLng1, zoom, tilt, bearing) val cameraUpdate9 = CameraUpdateFactory.newCameraPosition(cameraPosition)
您可以选择以动画方式或非动画方式移动相机。
以动画方式移动相机时,您还可以设置动画停止时的回调接口和动画持续的时间。默认动画持续时间为250毫秒。
以非动画方式移动相机是瞬时完成的。
“Java”
// 以动画方式移动地图相机
hMap.animateCamera(cameraUpdate);
// 以动画方式移动地图相机,并设置动画停止时的回调接口
hMap.animateCamera(cameraUpdate, cancelableCallback);
// 以动画方式移动地图相机,并设置动画停止时的回调接口和动画持续的时间
hMap.animateCamera(cameraUpdate, durationMs, cancelableCallback);
// 以非动画方式移动地图相机
hMap.moveCamera(cameraUpdate); “Kotlin”
// 以动画方式移动地图相机
hMap.animateCamera(cameraUpdate)
// 以动画方式移动地图相机,并设置动画停止时的回调接口
hMap.animateCamera(cameraUpdate, cancelableCallback)
// 以动画方式移动地图相机,并设置动画停止时的回调接口和动画持续的时间
hMap.animateCamera(cameraUpdate, durationMs, cancelableCallback)
// 以非动画方式移动地图相机
hMap.moveCamera(cameraUpdate) “Java” // 设置最小偏好缩放级别,范围为[3,20] hMap.setMinZoomPreference(3); // 设置最大偏好缩放级别,范围为[3,20] hMap.setMaxZoomPreference(14); // 重置最大最小缩放级别 hMap.resetMinMaxZoomPreference();
“Kotlin” // 设置最小偏好缩放级别 hMap.setMinZoomPreference(3f) // 设置最大偏好缩放级别 hMap.setMaxZoomPreference(14f) // 重置最大最小缩放级别 hMap.resetMinMaxZoomPreference()
地图SDK支持设置地图相机的边界。通过setLatLngBoundsForCameraTarget(LatLngBounds)接口指定一个LatLngBounds来约束相机目标,使用户漫游地图时,相机目标不会移出此边界。当设置参数为空时,地图相机的边界清除。