添加摄像头路径动画
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以向 3D 地图添加相机路径动画,为用户提供更具沉浸感的体验。相机路径动画可以飞向或环绕地图上的某个点。
前往
以下代码示例演示了如何通过调用 flyCameraTo
方法,使相机动画效果能够飞到 3D 地图上的特定点。如需使用此代码示例,请按照设置和向应用添加 3D 地图中的说明,在 Android Studio 项目中设置基本 3D 地图。然后,将以下代码添加到 MainActivity.kt
文件中:
// Add imports and define constants
import com.google.android.gms.maps3d.model.latLngAltitude
const val EMPIRE_STATE_BUILDING_LATITUDE = 40.748233
const val EMPIRE_STATE_BUILDING_LONGITUDE = -73.985663
...
// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.flyCameraTo(
flyToOptions {
endCamera = camera {
center = latLngAltitude {
latitude = EMPIRE_STATE_BUILDING_LATITUDE
longitude = EMPIRE_STATE_BUILDING_LONGITUDE
altitude = 212.0 // in meters
}
heading = 34.0 // bearing in degrees
tilt = 67.0 // relative to vertical
range = 750.0 // distance away from the focal point in meters
roll = 0.0 // roll relative to horizontal
}
durationInMillis = 2_000
}
)
飞来飞去
以下代码示例演示了如何通过调用 flyCameraAround
方法,使相机在 3D 地图上围绕特定点飞行。如需使用此代码示例,请按照设置和向应用添加 3D 地图中的说明操作,以使用基本 3D 地图设置 Android Studio 项目。然后,将以下代码添加到 MainActivity.kt
文件中:
// Add imports and define constants
import com.google.android.gms.maps3d.model.latLngAltitude
const val EMPIRE_STATE_BUILDING_LATITUDE = 40.748233
const val EMPIRE_STATE_BUILDING_LONGITUDE = -73.985663
...
// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.flyCameraAround(
flyAroundOptions {
center = camera {
center = latLngAltitude {
latitude = EMPIRE_STATE_BUILDING_LATITUDE
longitude = EMPIRE_STATE_BUILDING_LONGITUDE
altitude = 212.0
}
heading = 34.0
tilt = 67.0
range = 750.0
roll = 0.0
}
durationInMillis = 5_000
rounds = 1.0 // Number of rotations - can be fractional
}
)
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[],[],null,["# Add camera path animations\n\nSelect platform: [Android](/maps/documentation/maps-3d/android-sdk/custom-camera-paths \"View this page for the Android platform docs.\") [iOS](/maps/documentation/maps-3d/ios-sdk/custom-camera-paths \"View this page for the iOS platform docs.\")\n\n\u003cbr /\u003e\n\n| This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage descriptions](/maps/launch-stages).\n\n\nYou can add camera paths animations to your 3D map to provide a more immersive\nexperience for your users. Camera path animations can fly to or fly around a point on the map.\n\nFly to\n------\n\n\nThe following code sample demonstrates how to animate the camera to fly to a specific point on a 3D map by calling\nthe [`flyCameraTo`](/maps/documentation/maps-3d/android-sdk/reference/com/google/android/gms/maps3d/GoogleMap3D#flyCameraTo(com.google.android.gms.maps3d.model.FlyToOptions))\nmethod. To use this code sample, follow the instructions in\n[Setup](/maps/documentation/maps-3d/android-sdk/setup) and\n[Add a 3D map to your app](/maps/documentation/maps-3d/android-sdk/add-a-3d-map) to set\nup your Android Studio project with a basic 3D map. Then, add the following code to the\n**`MainActivity.kt`** file: \n\n```kotlin\n// Add imports and define constants\nimport com.google.android.gms.maps3d.model.latLngAltitude\nconst val EMPIRE_STATE_BUILDING_LATITUDE = 40.748233\nconst val EMPIRE_STATE_BUILDING_LONGITUDE = -73.985663\n\n...\n \n// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized\ngoogleMap3D.flyCameraTo(\n flyToOptions {\n endCamera = camera {\n center = latLngAltitude {\n latitude = EMPIRE_STATE_BUILDING_LATITUDE\n longitude = EMPIRE_STATE_BUILDING_LONGITUDE\n altitude = 212.0 // in meters\n }\n heading = 34.0 // bearing in degrees\n tilt = 67.0 // relative to vertical\n range = 750.0 // distance away from the focal point in meters\n roll = 0.0 // roll relative to horizontal\n }\n durationInMillis = 2_000\n }\n)\n```\n\nFly around\n----------\n\n\nThe following code sample demonstrates how to animate the camera to fly around a specific point on a 3D map by\ncalling the [`flyCameraAround`](/maps/documentation/maps-3d/android-sdk/reference/com/google/android/gms/maps3d/GoogleMap3D#flyCameraAround(com.google.android.gms.maps3d.model.FlyAroundOptions))\nmethod. To use this code sample, follow the\ninstructions in\n[Setup](/maps/documentation/maps-3d/android-sdk/setup) and\n[Add a 3D map to your app](/maps/documentation/maps-3d/android-sdk/add-a-3d-map)\nto set up your Android Studio project with a basic 3D map. Then, add the\nfollowing code to the **`MainActivity.kt`** file: \n\n```kotlin\n// Add imports and define constants\nimport com.google.android.gms.maps3d.model.latLngAltitude\nconst val EMPIRE_STATE_BUILDING_LATITUDE = 40.748233\nconst val EMPIRE_STATE_BUILDING_LONGITUDE = -73.985663\n\n...\n\n// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized\ngoogleMap3D.flyCameraAround(\n flyAroundOptions {\n center = camera {\n center = latLngAltitude {\n latitude = EMPIRE_STATE_BUILDING_LATITUDE\n longitude = EMPIRE_STATE_BUILDING_LONGITUDE\n altitude = 212.0\n }\n heading = 34.0\n tilt = 67.0\n range = 750.0\n roll = 0.0\n }\n durationInMillis = 5_000\n rounds = 1.0 // Number of rotations - can be fractional\n }\n)\n```"]]