public final class CameraPosition extends Object
implements Parcelable Parcelable

An immutable class that aggregates all camera position parameters such as location, zoom level, tilt angle, and bearing. Use CameraPosition.Builder to construct a CameraPosition instance, which you can then use in conjunction with CameraUpdateFactory. For more information, see Moving the camera.

Developer Guide

For more information, read the Camera and View developer guide.

Nested Class Summary

class CameraPosition.Builder Builds camera position. 

Inherited Constant Summary

Field Summary

public final float bearing Direction that the camera is pointing in, in degrees clockwise from north.
public final LatLng target The location that the camera is pointing at.
public final float tilt The angle, in degrees, of the camera angle from the nadir (directly facing the Earth).
public final float zoom Zoom level near the center of the screen.

Public Constructor Summary

CameraPosition(LatLng target, float zoom, float tilt, float bearing)
Constructs a CameraPosition.

Public Method Summary

static CameraPosition.Builder
builder(CameraPosition camera)
Creates a builder for a camera position, initialized to a given position.
static CameraPosition.Builder
builder()
Creates a builder for a camera position.
static CameraPosition
createFromAttributes(Context context, AttributeSet attrs)
Creates a CameraPosition from the AttributeSet.
boolean
equals(Object o)
static CameraPosition
fromLatLngZoom(LatLng target, float zoom)
Constructs a CameraPosition pointed for a particular target and zoom level.
int
hashCode()
String
toString()
void
writeToParcel(Parcel out, int flags)

Inherited Method Summary

Fields

public final float bearing

Direction that the camera is pointing in, in degrees clockwise from north.

public final LatLng target

The location that the camera is pointing at.

public final float tilt

The angle, in degrees, of the camera angle from the nadir (directly facing the Earth). See CameraPosition.Builder.tilt(float) for details of restrictions on the range of values.

public final float zoom

Zoom level near the center of the screen. See CameraPosition.Builder.zoom(float) for the definition of the camera's zoom level.

Public Constructors

public CameraPosition (LatLng target, float zoom, float tilt, float bearing)

Constructs a CameraPosition.

Parameters
target The target location to align with the center of the screen. Must not be null.
zoom Zoom level at target. See CameraPosition.Builder.zoom(float) for details of restrictions.
tilt The camera angle, in degrees, from the nadir (directly down). See CameraPosition.Builder.tilt(float) for details of restrictions.
bearing Direction that the camera is pointing in, in degrees clockwise from north. This value will be normalized to be within 0 degrees inclusive and 360 degrees exclusive.
Throws
NullPointerException if target is null
IllegalArgumentException if tilt is outside the range of 0 to 90 degrees inclusive.

Public Methods

public static CameraPosition.Builder builder (CameraPosition camera)

Creates a builder for a camera position, initialized to a given position.

public static CameraPosition.Builder builder ()

Creates a builder for a camera position.

public static CameraPosition createFromAttributes (Context context, AttributeSet attrs)

Creates a CameraPosition from the AttributeSet.

Returns
  • null if either context or attrs is null.

public boolean equals (Object o)

public static CameraPosition fromLatLngZoom (LatLng target, float zoom)

Constructs a CameraPosition pointed for a particular target and zoom level. The resultant bearing is North, and the viewing angle is perpendicular to the Earth's surface. i.e., directly facing the Earth's surface, with the top of the screen pointing North.

Parameters
target The target location to align with the center of the screen.
zoom Zoom level at target. See CameraPosition.Builder.zoom(float) for details on the range the value will be clamped to. The larger the value the more zoomed in the camera is.

public int hashCode ()

public String toString ()

public void writeToParcel (Parcel out, int flags)