Package com.kakao.vectormap.camera

Class CameraUpdateFactory

java.lang.Object

com.kakao.vectormap.camera.CameraUpdateFactory

public class CameraUpdateFactory
extends java.lang.Object

지도의 카메라를 변경하는 CameraUpdate 객체를 만드는 클래스이다. 카메라로 지도를 움직이려면 CameraUpdate 객체를 사용하며 KakaoMap.moveCamera(CameraUpdate) 를 호출하면 된다.

Field Summary

Fields

Modifier and Type	Field	Description
static int	FitMapPoints
static int	NewCameraAngle
static int	NewCameraPos
static int	NewCenterPoint
static int	Rotate
static int	Tilt
static int	ZoomIn
static int	ZoomOut
static int	ZoomTo

Constructor Summary

Constructors

Constructor	Description
CameraUpdateFactory()

Method Summary

Modifier and Type	Method	Description
static CameraUpdate	fitMapPoints(LatLng[] points)	주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.
static CameraUpdate	fitMapPoints(LatLng[] points, int padding)	주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.
static CameraUpdate	fitMapPoints(LatLng[] points, int padding, int maxZoomLevel)	주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.
static CameraUpdate	newCameraPosition(CameraPosition cameraPosition)	CameraPosition 에 속성 값 대로 위치와 방향, 회전 및 기울기를 설정한다.
static CameraUpdate	newCenterPosition(LatLng position)	이동 할 특정 위치를 설정한다.
static CameraUpdate	newCenterPosition(LatLng position, int zoomLevel)	이동 할 특정 위치와 ZoomLevel 을 설정한다.
static CameraUpdate	rotateTo(double rotationAngle)	지도의 회전 각도를 변경한다.
static CameraUpdate	tiltTo(double tiltAngle)	지도의 기울기 각도를 변경한다.
static CameraUpdate	zoomIn()	더 자세히 보이도록 지도를 한 단계 확대한다.
static CameraUpdate	zoomOut()	더 넓게 보이도록 지도를 한 단계 축소한다.
static CameraUpdate	zoomTo(int zoomLevel)	카메라의 높이, 지도의 확대/축소 수준을 변경한다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NewCenterPoint

public static final int NewCenterPoint

See Also:

Constant Field Values

NewCameraPos

public static final int NewCameraPos

See Also:

Constant Field Values

NewCameraAngle

public static final int NewCameraAngle

See Also:

Constant Field Values

ZoomTo

public static final int ZoomTo

See Also:

Constant Field Values

ZoomIn

public static final int ZoomIn

See Also:

Constant Field Values

ZoomOut

public static final int ZoomOut

See Also:

Constant Field Values

Rotate

public static final int Rotate

See Also:

Constant Field Values

Tilt

public static final int Tilt

See Also:

Constant Field Values

FitMapPoints

public static final int FitMapPoints

See Also:

Constant Field Values

Constructor Detail

CameraUpdateFactory

public CameraUpdateFactory()

Method Detail

newCenterPosition

public static CameraUpdate newCenterPosition(LatLng position)

이동 할 특정 위치를 설정한다.

Parameters:

position - 이동 할 새 위치 좌표.

newCenterPosition

public static CameraUpdate newCenterPosition(LatLng position,
                                             int zoomLevel)

이동 할 특정 위치와 ZoomLevel 을 설정한다.

Parameters:

position - 이동 할 새 위치 좌표.

zoomLevel - 변경 할 새 ZoomLevel.

newCameraPosition

public static CameraUpdate newCameraPosition(CameraPosition cameraPosition)

CameraPosition 에 속성 값 대로 위치와 방향, 회전 및 기울기를 설정한다.

Parameters:

cameraPosition - 카메라의 속성 CameraPosition.

rotateTo

public static CameraUpdate rotateTo(double rotationAngle)

지도의 회전 각도를 변경한다. 시계방향으로 회전 각도를 변경한다.

Parameters:

rotationAngle - 시계방향 회전 각도 (radian 값).

tiltTo

public static CameraUpdate tiltTo(double tiltAngle)

지도의 기울기 각도를 변경한다.

Parameters:

tiltAngle - 기울기 각도 (radian 값).

zoomIn

public static CameraUpdate zoomIn()

더 자세히 보이도록 지도를 한 단계 확대한다. KakaoMap.getZoomLevel() 값에서 한 단계 값을 올린다.

zoomOut

public static CameraUpdate zoomOut()

더 넓게 보이도록 지도를 한 단계 축소한다. KakaoMap.getZoomLevel() 값에서 한 단계 값을 내린다.

zoomTo

public static CameraUpdate zoomTo(int zoomLevel)

카메라의 높이, 지도의 확대/축소 수준을 변경한다. 값이 낮으면 더 넓게 보이도록 지도가 축소되고, 값이 높으면 더 자세히 보이도록 지도가 확대된다.

Parameters:

zoomLevel - 지도의 확대/축소 수준의 값. KakaoMap.getMinMapLevel() 값 보다 작을 수 없고, KakaoMap.getMaxMapLevel() 보다 클 수 없다.

fitMapPoints

public static CameraUpdate fitMapPoints(LatLng[] points)

주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.

Parameters:

points - 보여지기 원하는 위치(좌표)들의 배열.

fitMapPoints

public static CameraUpdate fitMapPoints(LatLng[] points,
                                        int padding)

주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.

Parameters:

points - 보여지기 원하는 위치(좌표)들의 배열.

padding - 화면의 가장자리로부터 padding 값 만큼 points 좌표가 안으로 들어와서 계산된다. (px 단위).

fitMapPoints

public static CameraUpdate fitMapPoints(LatLng[] points,
                                        int padding,
                                        int maxZoomLevel)

주어진 위치(좌표)들이 화면의 가장자리에 맞춰 보여지도록 카메라의 위치를 변경한다.

Parameters:

points - 보여지기 원하는 위치(좌표)들의 배열.

padding - 화면의 가장자리로부터 padding 값 만큼 points 좌표가 안으로 들어와서 계산된다. (px 단위)

maxZoomLevel - 카메라 높이 계산 될 때 더이상 확대 될 수 없는 limit maxZoomLevel 값을 설정한다. maxZoomLevel 보다 크게 지도가 확대 될 수 없다.