CameraUpdateFactory

공개 최종 클래스 CameraUpdateFactory 객체
를 확장합니다.

지도의 카메라를 변경하는 CameraUpdate 객체를 만들기 위한 메서드가 포함된 클래스입니다. 지도의 카메라를 수정하려면 이 클래스로 만든 CameraUpdate 객체를 사용하여 animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) 또는 moveCamera(CameraUpdate)를 호출합니다.

예를 들어 지도를 확대하려면 다음 코드를 사용할 수 있습니다. 

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

이 클래스의 메서드를 사용하기 전에 다음 중 하나를 실행하여 이 클래스는 다음과 같이 초기화됩니다.

개발자 가이드

자세한 내용은 카메라 및 뷰를 참고하세요. 참조하세요.

공개 메서드 요약

정적 CameraUpdate
newCameraPosition(CameraPosition cameraPosition)
카메라를 지정된 CameraPosition로 이동하는 CameraUpdate를 반환합니다.
정적 CameraUpdate
newLatLng(LatLng latLng)
화면 중앙을 위도와 경도로 이동하는 CameraUpdate를 반환합니다. LatLng 객체로 지정됩니다.
정적 CameraUpdate
newLatLngBounds(LatLngBounds 경계, 정수 너비, 정수 높이, 정수 패딩)
지정된CameraUpdate 위도/경도 경계가 지정된 크기의 경계 상자 내에서 화면 중앙에 표시됩니다. 할 수 있습니다.
정적 CameraUpdate
newLatLngBounds(LatLngBounds 경계, 정수 패딩)
지정된CameraUpdate 위도/경도 경계가 가능한 가장 큰 확대/축소 수준에서 화면의 중앙에 표시됩니다.
정적 CameraUpdate
newLatLngZoom(LatLng latLng, 부동 소수점 확대/축소)
화면 중앙을 위도와 경도로 이동하는 CameraUpdate를 반환합니다. LatLng 객체로 지정되고 지정된 확대/축소 수준으로 이동합니다.
정적 CameraUpdate
scrollBy(부동 xPixel, 플로팅 yPixel)
카메라를 지도 위로 스크롤하여 중심을 이동하는 CameraUpdate를 반환합니다. x 및 y 방향으로 지정된 픽셀 수만큼 이미지를 볼 수 있습니다.
정적 CameraUpdate
zoomBy(부동 소수점 수, 포인트 포커스)
현재 카메라 시점의 확대/축소 수준을 이동하는 CameraUpdate를 반환합니다.
정적 CameraUpdate
zoomBy(부동 소수점 수)
현재 카메라 시점의 확대/축소 수준을 이동하는 CameraUpdate를 반환합니다.
정적 CameraUpdate
zoomIn()
시점의 높이를 더 가깝게 이동하여 지도를 확대하는 CameraUpdate를 반환합니다. 빛을 냅니다.
정적 CameraUpdate
zoomOut()
시점의 높이를 이동하여 지도를 축소하는 CameraUpdate를 반환합니다. 지구 표면에서 더 멀리 떨어져 있기 때문입니다.
정적 CameraUpdate
zoomTo(부동 소수점 수)
카메라 시점을 특정 확대/축소 수준으로 이동하는 CameraUpdate를 반환합니다.

상속받은 메서드 요약

공개 메서드

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate newCameraPosition (CameraPosition cameraPosition)

카메라를 지정된 CameraPosition로 이동하는 CameraUpdate를 반환합니다. 포함 CameraPosition 객체의 위도에서 경도, 확대/축소 수준, 방위 및 기울기

매개변수
cameraPosition
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate newLatLng (LatLng latLng)

화면 중앙을 위도와 경도로 이동하는 CameraUpdate를 반환합니다. LatLng 객체로 지정됩니다. 이렇게 하면 카메라가 LatLng 객체의 중앙에 배치됩니다.

매개변수
latLng 원하는 위도와 경도가 포함된 LatLng 객체입니다.
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate newLatLngBounds (LatLngBounds 경계, 정수 너비, 정수 높이, 정수 패딩)

지정된CameraUpdate 위도/경도 경계가 지정된 크기의 경계 상자 내에서 화면 중앙에 표시됩니다. 할 수 있습니다. 추가 패딩을 지정하여 광고 크기를 더욱 제한할 수 있습니다. 경계 상자의 크기입니다. 반환된 CameraUpdate의 방위는 0이고 기울기가 있습니다. 를 0으로 설정합니다.

newLatLngBounds(LatLngBounds, int)와 달리 CameraUpdate 지도의 레이아웃 단계 전에 카메라를 변경하기 위해 이 메서드에서 반환합니다. 인수는 경계 상자의 원하는 크기를 지정합니다.

매개변수
bounds 경계 상자에 들어가는 영역
너비 경계 상자 너비 (픽셀)
높이 경계 상자 높이 (픽셀)
패딩 경계 상자의 추가 크기 제한 (px)
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate newLatLngBounds (LatLngBounds 경계, int 패딩)

지정된CameraUpdate 위도/경도 경계가 가능한 가장 큰 확대/축소 수준에서 화면의 중앙에 표시됩니다. 다음과 같은 작업을 할 수 있습니다. 패딩을 지정하여 지도뷰의 가장자리에서 경계 상자를 삽입해야 합니다. 반환된 CameraUpdate의 방위는 0이고 기울기는 0입니다.

지도에 레이아웃이 적용될 때까지( 이 메서드가 적절한 경계 상자와 확대/축소 수준을 올바르게 결정하도록 하려면 지도에 크기가 있어야 함). 그러지 않으면 IllegalStateException이 발생합니다. 다음은 아닙니다. 지도를 사용할 수 있을 만큼 충분합니다. 지도를 포함하는 보기에 레이아웃의 크기가 정해집니다. 문제가 없는지 확신할 수 없는 경우 대신 newLatLngBounds(LatLngBounds, int, int, int)를 사용하고 수동으로 지도의 크기를 조정합니다.

매개변수
bounds 화면에 맞추기
패딩 경계 상자 가장자리와 뷰 가장자리 사이에 남겨둘 간격 (px)입니다. 이 값이 경계 상자의 네 면 모두에 적용됩니다.
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate newLatLngZoom (LatLng 위도/경도, 부동 소수점 확대/축소)

화면 중앙을 위도와 경도로 이동하는 CameraUpdate를 반환합니다. LatLng 객체로 지정되고 지정된 확대/축소 수준으로 이동합니다.

매개변수
latLng 원하는 위도와 경도가 포함된 LatLng 객체입니다.
확대/축소 2.0~21.0 범위에서 원하는 확대/축소 수준을 설정할 수 있습니다. 이 범위 아래의 값은 2.0으로 설정되고, 이를 초과하는 값은 21.0으로 설정됩니다. 값을 높여 확대합니다. 일부 영역에는 가장 큰 확대/축소 수준의 타일이 있습니다.
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate scrollBy (부동 x픽셀, 플로팅 yPixel)

카메라를 지도 위로 스크롤하여 중심을 이동하는 CameraUpdate를 반환합니다. x 및 y 방향으로 지정된 픽셀 수만큼 이미지를 볼 수 있습니다.

예:

  • xPixel이 5이고 yPixel이 0이면 시스템이 카메라를 움직여 오른쪽으로 지도에서 왼쪽으로 5픽셀 이동한 것으로 보입니다.
  • xPixel이 0이고 yPixel이 5이면 시스템이 카메라를 움직여 지도가 5픽셀 위로 이동한 것으로 보입니다.

스크롤은 카메라의 현재 방향에 따라 다릅니다. 예를 들어 카메라가 방위가 90도이고 동쪽이 '위'임 오른쪽으로 스크롤하면 카메라가 남쪽으로 이동합니다.

매개변수
xPixel 가로로 스크롤할 픽셀 수입니다. 양수 값은 카메라를 현재 방향에 따라 오른쪽이 표시됩니다. 음수 값은 카메라를 현재 방향에 따라 왼쪽이 표시됩니다.
yPixel 세로로 스크롤할 픽셀 수입니다. 양수 값은 카메라를 이동합니다. 현재 방향에 따라 아래쪽으로 이동합니다 음수 값은 카메라를 이동합니다. 현재 방향에 따라 위쪽으로 이동합니다
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate zoomBy (부동 소수점 수, 포인트 포커스)

현재 카메라 시점의 확대/축소 수준을 이동하는 CameraUpdate를 반환합니다.

초점으로 지정된 지점은 고정된 상태로 유지됩니다. 즉, 볼 수 있습니다.

이 메서드는 확대/축소가 현재를 기준으로 한다는 점에서 zoomTo(float)와 다릅니다. 있습니다.

예를 들어 LatLng (11.11, 22.22)이 현재 화면 위치 (23, 참조). 확대/축소 금액과 이 LatLng로 이 메서드를 호출한 후 화면 위치 이 LatLng의 값은 여전히 (23, 45)입니다.

매개변수
amount 금액을 조정할 수 있습니다. 양수 값은 음수 값은 지표면에서 멀어지고 있음을 나타냅니다. 있습니다.
초점 화면의 픽셀 위치가 있어야 합니다. 카메라가 움직이기 전에 픽셀 위치에 있던 위도/경도는 동일하게 유지됩니다. 카메라가 이동한 후
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate zoomBy (부동 소수점 수)

현재 카메라 시점의 확대/축소 수준을 이동하는 CameraUpdate를 반환합니다.

이 메서드는 확대/축소가 현재를 기준으로 한다는 점에서 zoomTo(float)와 다릅니다. 있습니다.

매개변수
amount 금액을 조정할 수 있습니다. 양수 값은 음수 값은 지표면에서 멀어지고 있음을 나타냅니다. 있습니다.
반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate zoomIn ()

시점의 높이를 더 가깝게 이동하여 지도를 확대하는 CameraUpdate를 반환합니다. 빛을 냅니다. 확대/축소 배율은 1.0입니다.

반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate zoomOut ()

시점의 높이를 이동하여 지도를 축소하는 CameraUpdate를 반환합니다. 지구 표면에서 더 멀리 떨어져 있기 때문입니다. 확대/축소 배율은 -1.0입니다.

반환 값

<ph type="x-smartling-placeholder"></ph> 공개 정적 CameraUpdate zoomTo (플로팅 확대/축소)

카메라 시점을 특정 확대/축소 수준으로 이동하는 CameraUpdate를 반환합니다.

매개변수
확대/축소 2.0~21.0 범위에서 원하는 확대/축소 수준을 설정할 수 있습니다. 이 범위 아래의 값은 2.0으로 설정되고, 이를 초과하는 값은 21.0으로 설정됩니다. 값을 높여 확대합니다. 일부 영역에는 가장 큰 확대/축소 수준의 타일이 있습니다.