사용자는 지도에서 동작을 사용하여 카메라의 확대/축소, 기울기, 위치, 회전을 제어할 수 있습니다.
프로그래매틱 방식으로 카메라를 구성할 수도 있습니다.
카메라 위치
지도 뷰는 카메라가 3D 공간의 특정 지점을 바라보는 것으로 모델링됩니다.
카메라의 위치와 방향 (및 이에 따른 지도의 렌더링)은 중심 (카메라가 바라보는 위도/경도/고도 위치), 방향, 기울기, 범위, 회전 등의 속성으로 지정됩니다.
중심 (위도/경도/고도)
center는 카메라가 관찰하는 3D 공간의 특정 지점을 정의합니다.
위도, 경도, 고도 값을 사용하여 지정됩니다. 이를 통해 3차원에서 카메라 초점의 정확한 위치를 지정할 수 있습니다.
위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내의 가장 가까운 값으로 고정됩니다. 예를 들어 위도를 100으로 지정하면 값이 90으로 설정됩니다. 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 고도는 해발 고도(미터)로 지정됩니다.
제목
카메라 방향은 카메라가 가리키는 방향을 지정하며, 진북에서 시계 방향으로 측정됩니다(단위: 도). 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도에 해당합니다. 이는 중심점의 세로 축을 기준으로 카메라의 방향을 결정합니다.
기울이기
기울기는 카메라가 수직 축을 기준으로 기울어진 각도를 지정하며, 단위는 도입니다. 기울기가 0도이면 카메라가 지구 (천저)를 향해 아래로 향하고 있음을 의미합니다. 기울기가 90도이면 카메라가 방향으로 지정된 방향을 향해 수평으로 향합니다.
범위
범위는 카메라의 자체 위치와 카메라가 바라보는 중심점 사이의 거리를 미터 단위로 정의합니다. 범위는 0미터 (매우 가까운 거리)에서 최대 6,300만 미터까지 다양하며, 매우 가까운 거리에서부터 진정한 전 세계적 관점에 이르기까지 다양한 뷰를 허용합니다. 이는 지도가 '확대' 또는 '축소'되는 방식을 효과적으로 제어합니다.
카메라 롤
롤은 지평선과 관련하여 카메라의 각도를 설정하며, 단위는 도입니다. 이 매개변수를 사용하면 비행 시뮬레이션 중 뱅킹과 같은 효과를 만들거나 카메라를 시청 축을 중심으로 회전시켜 완전한 배럴 롤을 만들 수도 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# Configure camera controls\n\nSelect platform: [Android](/maps/documentation/maps-3d/android-sdk/configure-camera-controls \"View this page for the Android platform docs.\") [iOS](/maps/documentation/maps-3d/ios-sdk/configure-camera-controls \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/3d/map-controls \"View this page for the JavaScript 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\nUsers can control the zoom, tilt, position, and rotation of the camera using gestures on the map.\nYou can also configure the camera programmatically.\n\nThe Camera Position\n-------------------\n\nThe map view is modeled as a **camera** looking at a specific point in a 3D space.\nThe position and orientation of the camera (and hence the rendering of the map) are specified by\nthe following properties: center (a latitude/longitude/altitude location the camera is looking\nat), heading, tilt, range, and roll.\n\n### Center (Latitude/Longitude/Altitude)\n\nThe **center** defines the specific point in 3D space that the camera is observing.\nThis is\nspecified using values for latitude, longitude, and altitude. This allows for precise\npositioning of the camera's focal point in three dimensions.\n\n\nThe latitude can be between -90 and 90 degrees, inclusive. Values\nabove or below this range will be clamped to the nearest value within this range. For example,\nspecifying a latitude of 100 will set the value to 90. Longitude\nranges between -180 and 180 degrees, inclusive. Altitude is specified in meters above\nsea level.\n\n### Heading\n\nThe camera **heading** specifies the direction the camera will point, measured in\ndegrees clockwise from true North. North corresponds to 0 degrees, East to 90 degrees, South to\n180 degrees, and West to 270 degrees. This determines the orientation of the camera around the\nvertical axis of the [center point](#center_location).\n\n### Tilt\n\nThe **tilt** specifies the angle of the camera with respect to the vertical axis,\nmeasured in degrees. A tilt of 0 degrees means the camera is pointing straight down towards the\nEarth ([nadir](https://en.wikipedia.org/wiki/Nadir)). A tilt of 90\ndegrees means the camera is pointed horizontally in the direction\nspecified by the [heading](#heading_orientation).\n\n### Range\n\nThe **range** defines the distance in meters between the camera's own position and\nthe [center point](#center_location) it is looking at. The range can vary from zero\nmeters (very close up) up to sixty-three million meters, allowing for views from very close up all\nthe way to a truly global perspective. This effectively controls how \"zoomed in\" or \"zoomed out\"\nthe map appears.\n\n### Roll\n\n\nThe **roll** sets the angle of the camera with respect to the horizon,\nmeasured in degrees. This parameter can be used to create effects like banking during flight\nsimulations or even a full barrel roll, rotating the camera around its viewing axis.\n\nControlling the camera\n----------------------\n\nThe following code sample demonstrates how to control the camera programmatically. \n\n### Swift\n\n```swift\npublic static var sanFrancisco: Camera = .init(\n latitude: 37.7845812,\n longitude: -122.3660241,\n altitude: 585,\n heading: 288.0,\n tilt: 75.0,\n roll: 0.0,\n range: 100)\n\n \n```"]]
