com.mapbox.mapboxsdk.camera

Class CameraUpdateFactory

java.lang.Object

com.mapbox.mapboxsdk.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, double bearing, double tilt, 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 while using provided bearing and tilt values.
static CameraUpdate	newLatLngBounds(LatLngBounds bounds, double bearing, double tilt, 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 while using provided bearing and tilt values.
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 while maintaining current camera position bearing and tilt values.
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 while maintaining current camera position bearing and tilt values.
static CameraUpdate	newLatLngPadding(LatLng latLng, double left, double top, double right, double bottom) 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	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 taking the specified padding into account.
static CameraUpdate	paddingTo(double[] padding) Returns a CameraUpdate that when animated changes the camera padding.
static CameraUpdate	paddingTo(double left, double top, double right, double bottom) Returns a CameraUpdate that when animated changes the camera padding.
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 while maintaining current camera position bearing and tilt values.

You can specify padding, in order to inset the bounding box from the map view's edges. The padding will not persist and impact following camera transformations.

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,
                                           double bearing,
                                           double tilt,
                                           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 while using provided bearing and tilt values.

You can specify padding, in order to inset the bounding box from the map view's edges. The padding will not persist and impact following camera transformations.

Parameters:

bounds - Bounds to match Camera position with

bearing - Bearing to take in account when generating the bounds

tilt - Tilt to take in account when generating the bounds

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 while maintaining current camera position bearing and tilt values.

You can specify padding, in order to inset the bounding box from the map view's edges. The padding will not persist and impact following camera transformations.

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

newLatLngBounds

public static CameraUpdate newLatLngBounds(@NonNull
                                           LatLngBounds bounds,
                                           double bearing,
                                           double tilt,
                                           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 while using provided bearing and tilt values.

You can specify padding, in order to inset the bounding box from the map view's edges. The padding will not persist and impact following camera transformations.

Parameters:

bounds - Bounds to base the Camera position out of

bearing - Bearing to take in account when generating the bounds

tilt - Tilt to take in account when generating the bounds

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 taking the specified padding into account.

Parameters:

latLng - Target location to change to

zoom - Zoom level to change to

Returns:

CameraUpdate Final Camera Position

newLatLngPadding

public static CameraUpdate newLatLngPadding(@NonNull
                                            LatLng latLng,
                                            double left,
                                            double top,
                                            double right,
                                            double bottom)

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. Applied padding is going to persist and impact following camera transformations.

Parameters:

latLng - Target location to change to

left - Left padding

top - Top padding

right - Right padding

bottom - Bottom padding

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

paddingTo

public static CameraUpdate paddingTo(double[] padding)

Returns a CameraUpdate that when animated changes the camera padding. Applied padding is going to persist and impact following camera transformations.

Specified in left, top, right, bottom order.

Parameters:

padding - Padding to change to

Returns:

CameraUpdate Final Camera Position

paddingTo

public static CameraUpdate paddingTo(double left,
                                     double top,
                                     double right,
                                     double bottom)

Returns a CameraUpdate that when animated changes the camera padding. Applied padding is going to persist and impact following camera transformations.

Specified in left, top, right, bottom order.

Returns:

CameraUpdate Final Camera Position