com.dingi.dingisdk.camera

Class CameraUpdateFactory

java.lang.Object

com.dingi.dingisdk.camera.CameraUpdateFactory

public final class CameraUpdateFactory
extends java.lang.Object

Factory for creating CameraUpdate objects.

Constructor Summary

Constructors

Constructor and Description
CameraUpdateFactory()

Method Summary

Modifier and Type	Method and Description
static CameraUpdate	bearingTo(double bearing) Returns a CameraUpdate that moves the camera viewpoint to a particular bearing.
static CameraUpdate	newCameraPosition(CameraPosition cameraPosition) Returns a CameraUpdate that moves the camera to a specified CameraPosition.
static CameraUpdate	newLatLng(LatLng latLng) Returns a CameraUpdate that moves the center of the screen to a latitude and longitude specified by a LatLng object.
static CameraUpdate	newLatLngBounds(LatLngBounds bounds, int padding) Returns a CameraUpdate that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level.
static CameraUpdate	newLatLngBounds(LatLngBounds bounds, int paddingLeft, int paddingTop, int paddingRight, int paddingBottom) Returns a CameraUpdate that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level.
static CameraUpdate	newLatLngZoom(LatLng latLng, double zoom) Returns a CameraUpdate that moves the center of the screen to a latitude and longitude specified by a LatLng object, and moves to the given zoom level.
static CameraUpdate	scrollBy(float xPixel, float yPixel) Deprecated. use DingiMap.scrollBy(float, float) for more precise displacements when using a padded map.
static CameraUpdate	tiltTo(double tilt) Returns a CameraUpdate that moves the camera viewpoint to a particular tilt.
static CameraUpdate	zoomBy(double amount) Returns a CameraUpdate that shifts the zoom level of the current camera viewpoint.
static CameraUpdate	zoomBy(double amount, android.graphics.Point focus) Returns a CameraUpdate that shifts the zoom level of the current camera viewpoint.
static CameraUpdate	zoomIn() Returns a CameraUpdate that zooms in on the map by moving the viewpoint's height closer to the Earth's surface.
static CameraUpdate	zoomOut() Returns a CameraUpdate that zooms out on the map by moving the viewpoint's height farther away from the Earth's surface.
static CameraUpdate	zoomTo(double zoom) Returns a CameraUpdate that moves the camera viewpoint to a particular zoom level.

Methods inherited from class java.lang.Object

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

Constructor Detail

CameraUpdateFactory

public CameraUpdateFactory()

Method Detail

newCameraPosition

public static CameraUpdate newCameraPosition(@NonNull
                                             CameraPosition cameraPosition)

Returns a CameraUpdate that moves the camera to a specified CameraPosition.

Parameters:

cameraPosition - Camera Position to change to

Returns:

CameraUpdate Final Camera Position

newLatLng

public static CameraUpdate newLatLng(@NonNull
                                     LatLng latLng)

Returns a CameraUpdate that moves the center of the screen to a latitude and longitude specified by a LatLng object. This centers the camera on the LatLng object.

Parameters:

latLng - Target location to change to

Returns:

CameraUpdate Final Camera Position

newLatLngBounds

public static CameraUpdate newLatLngBounds(@NonNull
                                           LatLngBounds bounds,
                                           int padding)

Returns a CameraUpdate that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level. You can specify padding, in order to inset the bounding box from the map view's edges. The returned CameraUpdate has a bearing of 0 and a tilt of 0.

Parameters:

bounds - Bounds to match Camera position with

padding - Padding added to the bounds

Returns:

CameraUpdate Final Camera Position

newLatLngBounds

public static CameraUpdate newLatLngBounds(@NonNull
                                           LatLngBounds bounds,
                                           int paddingLeft,
                                           int paddingTop,
                                           int paddingRight,
                                           int paddingBottom)

Returns a CameraUpdate that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level. You can specify padding, in order to inset the bounding box from the map view's edges. The returned CameraUpdate has a bearing of 0 and a tilt of 0.

Parameters:

bounds - Bounds to base the Camera position out of

paddingLeft - Padding left of the bounds

paddingTop - Padding top of the bounds

paddingRight - Padding right of the bounds

paddingBottom - Padding bottom of the bounds

Returns:

CameraUpdate Final Camera Position

newLatLngZoom

public static CameraUpdate newLatLngZoom(@NonNull
                                         LatLng latLng,
                                         double zoom)

Returns a CameraUpdate that moves the center of the screen to a latitude and longitude specified by a LatLng object, and moves to the given zoom level.

Parameters:

latLng - Target location to change to

zoom - Zoom level to change to

Returns:

CameraUpdate Final Camera Position

scrollBy

@Deprecated
public static CameraUpdate scrollBy(float xPixel,
                                                float yPixel)

Deprecated. use DingiMap.scrollBy(float, float) for more precise displacements when using a padded map.

Returns a CameraUpdate that scrolls the camera over the map, shifting the center of view by the specified number of pixels in the x and y directions.

Parameters:

xPixel - Amount of pixels to scroll to in x direction

yPixel - Amount of pixels to scroll to in y direction

Returns:

CameraUpdate Final Camera Position

zoomBy

public static CameraUpdate zoomBy(double amount,
                                  android.graphics.Point focus)

Returns a CameraUpdate that shifts the zoom level of the current camera viewpoint.

Parameters:

amount - Amount of zoom level to change with

focus - Focus point of zoom

Returns:

CameraUpdate Final Camera Position

zoomBy

public static CameraUpdate zoomBy(double amount)

Returns a CameraUpdate that shifts the zoom level of the current camera viewpoint.

Parameters:

amount - Amount of zoom level to change with

Returns:

CameraUpdate Final Camera Position

zoomIn

public static CameraUpdate zoomIn()

Returns a CameraUpdate that zooms in on the map by moving the viewpoint's height closer to the Earth's surface. The zoom increment is 1.0.

Returns:

CameraUpdate Final Camera Position

zoomOut

public static CameraUpdate zoomOut()

Returns a CameraUpdate that zooms out on the map by moving the viewpoint's height farther away from the Earth's surface. The zoom increment is -1.0.

Returns:

CameraUpdate Final Camera Position

zoomTo

public static CameraUpdate zoomTo(double zoom)

Returns a CameraUpdate that moves the camera viewpoint to a particular zoom level.

Parameters:

zoom - Zoom level to change to

Returns:

CameraUpdate Final Camera Position

bearingTo

public static CameraUpdate bearingTo(double bearing)

Returns a CameraUpdate that moves the camera viewpoint to a particular bearing.

Parameters:

bearing - Bearing to change to

Returns:

CameraUpdate Final Camera Position

tiltTo

public static CameraUpdate tiltTo(double tilt)

Returns a CameraUpdate that moves the camera viewpoint to a particular tilt.

Parameters:

tilt - Tilt to change to

Returns:

CameraUpdate Final Camera Position