3D 지도에 카메라 경로 애니메이션을 추가하여 사용자에게 더욱 몰입감 있는 환경을 제공할 수 있습니다. 카메라 경로 애니메이션은 지도상의 한 지점으로 이동하거나 그 지점을 중심으로 이동할 수 있습니다.
빠른 이동
다음 코드 샘플은 flyCameraTo 메서드를 호출하여 3D 지도의 특정 지점으로 이동하도록 카메라를 애니메이션 처리하는 방법을 보여줍니다. 이 코드 샘플을 사용하려면 설정 및 앱에 3D 지도 추가의 안내에 따라 기본 3D 지도로 Android 스튜디오 프로젝트를 설정하세요. 그런 다음 MainActivity.kt 파일에 다음 코드를 추가합니다.
// Add imports and define constantsimportcom.google.android.gms.maps3d.model.latLngAltitudeconstvalEMPIRE_STATE_BUILDING_LATITUDE=40.748233constvalEMPIRE_STATE_BUILDING_LONGITUDE=-73.985663...// Add to the onMap3DViewReady method, after the googleMap3D object has been initializedgoogleMap3D.flyCameraTo(flyToOptions{endCamera=camera{center=latLngAltitude{latitude=EMPIRE_STATE_BUILDING_LATITUDElongitude=EMPIRE_STATE_BUILDING_LONGITUDEaltitude=212.0// in meters}heading=34.0// bearing in degreestilt=67.0// relative to verticalrange=750.0// distance away from the focal point in metersroll=0.0// roll relative to horizontal}durationInMillis=2_000})
둘러보기
다음 코드 샘플은 flyCameraAround 메서드를 호출하여 3D 지도의 특정 지점을 중심으로 카메라가 이동하도록 애니메이션을 적용하는 방법을 보여줍니다. 이 코드 샘플을 사용하려면 설정 및 앱에 3D 지도 추가의 안내에 따라 기본 3D 지도로 Android 스튜디오 프로젝트를 설정하세요. 그런 다음 다음 코드를 MainActivity.kt 파일에 추가합니다.
// Add imports and define constantsimportcom.google.android.gms.maps3d.model.latLngAltitudeconstvalEMPIRE_STATE_BUILDING_LATITUDE=40.748233constvalEMPIRE_STATE_BUILDING_LONGITUDE=-73.985663...// Add to the onMap3DViewReady method, after the googleMap3D object has been initializedgoogleMap3D.flyCameraAround(flyAroundOptions{center=camera{center=latLngAltitude{latitude=EMPIRE_STATE_BUILDING_LATITUDElongitude=EMPIRE_STATE_BUILDING_LONGITUDEaltitude=212.0}heading=34.0tilt=67.0range=750.0roll=0.0}durationInMillis=5_000rounds=1.0// Number of rotations - can be fractional})
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],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```"]]
