CameraPosition.Builder | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - Get Started
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
    - Get the SDK
  - Google Services
- - Google Play
  - Publishing
  - Promoting
  - App Quality
  - Spotlight
  - Open Distribution

## Results

Loading...
Summary: Ctors | Methods | Inherited Methods | [Expand All]
public static final class

# CameraPosition.Builder

extends Object

java.lang.Object
↳ | com.google.android.gms.maps.model.CameraPosition.Builder

## Class Overview

Builds camera position.

## Summary

Public Constructors
| CameraPosition.Builder() Creates an empty builder.
| CameraPosition.Builder(CameraPosition previous)

Public Methods
CameraPosition.Builder | bearing(float bearing) Sets the direction that the camera is pointing in, in degrees clockwise from north.
CameraPosition | build() Builds a `CameraPosition`.
CameraPosition.Builder | target(LatLng location) Sets the location that the camera is pointing at.
CameraPosition.Builder | tilt(float tilt) Sets the angle, in degrees, of the camera from the nadir (directly facing the Earth).
CameraPosition.Builder | zoom(float zoom) Sets the zoom level of the camera.

[Expand] Inherited Methods
From class java.lang.Object
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)

## Public Constructors

#### public CameraPosition.Builder ()

Creates an empty builder.

#### public CameraPosition.Builder (CameraPosition previous)

## Public Methods

#### public CameraPosition.Builder bearing (float bearing)

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

#### public CameraPosition build ()

Builds a `CameraPosition`.

#### public CameraPosition.Builder target (LatLng location)

Sets the location that the camera is pointing at.

#### public CameraPosition.Builder tilt (float tilt)

Sets the angle, in degrees, of the camera from the nadir (directly facing the Earth). When changing the camera position for a map, this value is restricted depending on the zoom level of the camera. The restrictions are as follows:

- For zoom levels less than 10 the maximum is 30.
- For zoom levels from 10 to 14 the maximum increases linearly from 30 to 45 (e.g. at zoom level 12, the maximum is 37.5).
- For zoom levels from 14 to 15.5 the maximum increases linearly from 45 to 67.5.
- For zoom levels greater than 15.5 the maximum is 67.5.

The minimum is always 0 (directly down). If you specify a value outside this range and try to move the camera to this camera position it will be clamped to these bounds.

#### public CameraPosition.Builder zoom (float zoom)

Sets the zoom level of the camera. Zoom level is defined such that at zoom level 0, the whole world is approximately 256dp wide (assuming that the camera is not tilted). Increasing the zoom level by 1 doubles the width of the world on the screen. Hence at zoom level N, the width of the world is approximately 256 * 2 N dp, i.e., at zoom level 2, the whole world is approximately 1024dp wide.

When changing the camera position for a map, the zoom level of the camera is restricted to a certain range depending on various factors including location, map type and map size. Use `GoogleMap.getMinZoomLevel` and `GoogleMap.getMaxZoomLevel` to find the restrictions. Note that the camera zoom need not be an integer value.