implements ReflectedParcelable
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
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 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. |
---|---|
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.
Parameters
camera |
---|
public static CameraPosition createFromAttributes (Context context, AttributeSet attrs)
Creates a CameraPosition from the AttributeSet
.
Parameters
context | |
---|---|
attrs |
public boolean equals (Object o)
Parameters
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)
Parameters
out | |
---|---|
flags |