GMSMutableCameraPosition Class Reference

GMSMutableCameraPosition Class Reference

Overview

Mutable version of GMSCameraPosition.

Inherits GMSCameraPosition.

Public Member Functions

(instancetype) - initWithTarget:zoom:bearing:viewingAngle:
 Designated initializer.
(instancetype) - initWithTarget:zoom:
 Convenience initializer for GMSCameraPosition for a particular target and zoom level.
(instancetype) - initWithLatitude:longitude:zoom:
 Convenience initializer for GMSCameraPosition for a particular latitidue, longitude and zoom level.
(instancetype) - initWithLatitude:longitude:zoom:bearing:viewingAngle:
 Convenience initializer for GMSCameraPosition, with latitude/longitude and all other camera properties as per -initWithTarget:zoom:bearing:viewingAngle:.

Static Public Member Functions

(instancetype) + cameraWithTarget:zoom:
 Convenience constructor for GMSCameraPosition for a particular target and zoom level.
(instancetype) + cameraWithLatitude:longitude:zoom:
 Convenience constructor for GMSCameraPosition, as per cameraWithTarget:zoom:.
(instancetype) + cameraWithTarget:zoom:bearing:viewingAngle:
 Convenience constructor for GMSCameraPosition, with all camera properties as per initWithTarget:zoom:bearing:viewingAngle:.
(instancetype) + cameraWithLatitude:longitude:zoom:bearing:viewingAngle:
 Convenience constructor for GMSCameraPosition, with latitude/longitude and all other camera properties as per initWithTarget:zoom:bearing:viewingAngle:.
(float) + zoomAtCoordinate:forMeters:perPoints:
 Get the zoom level at which meters distance, at given coord on Earth, correspond to the specified number of screen points.

Properties

CLLocationCoordinate2D target
float zoom
CLLocationDirection bearing
double viewingAngle

Member Function Documentation

- (instancetype) initWithTarget: (CLLocationCoordinate2D)  target
zoom: (float)  zoom
bearing: (CLLocationDirection)  bearing
viewingAngle: (double)  viewingAngle 

Designated initializer.

Configures this GMSCameraPosition with all available camera properties. Building a GMSCameraPosition via this initializer (or by the following convenience constructors) will implicitly clamp camera values.

Parameters:
targetLocation on the earth towards which the camera points.
zoomThe zoom level near the center of the screen.
bearingBearing of the camera in degrees clockwise from true north.
viewingAngleThe angle, in degrees, of the camera angle from the nadir (directly facing the Earth)
- (instancetype) initWithTarget: (CLLocationCoordinate2D)  target
zoom: (float)  zoom 

Convenience initializer for GMSCameraPosition for a particular target and zoom level.

This will set the bearing and viewingAngle properties of this camera to zero defaults (i.e., directly facing the Earth's surface, with the top of the screen pointing north).

Parameters:
targetLocation on the earth towards which the camera points.
zoomThe zoom level near the center of the screen.
- (instancetype) initWithLatitude: (CLLocationDegrees)  latitude
longitude: (CLLocationDegrees)  longitude
zoom: (float)  zoom 

Convenience initializer for GMSCameraPosition for a particular latitidue, longitude and zoom level.

This will set the bearing and viewingAngle properties of this camera to zero defaults (i.e., directly facing the Earth's surface, with the top of the screen pointing north).

Parameters:
latitudeThe latitude component of the location towards which the camera points.
longitudeThe latitude component of the location towards which the camera points.
zoomThe zoom level near the center of the screen.
- (instancetype) initWithLatitude: (CLLocationDegrees)  latitude
longitude: (CLLocationDegrees)  longitude
zoom: (float)  zoom
bearing: (CLLocationDirection)  bearing
viewingAngle: (double)  viewingAngle 

Convenience initializer for GMSCameraPosition, with latitude/longitude and all other camera properties as per -initWithTarget:zoom:bearing:viewingAngle:.

Parameters:
latitudeThe latitude component of the location towards which the camera points.
longitudeThe latitude component of the location towards which the camera points.
zoomThe zoom level near the center of the screen.
bearingBearing of the camera in degrees clockwise from true north.
viewingAngleThe angle, in degrees, of the camera angle from the nadir (directly facing the Earth)
+ (instancetype) cameraWithTarget: (CLLocationCoordinate2D)  target
zoom: (float)  zoom 

Convenience constructor for GMSCameraPosition for a particular target and zoom level.

This will set the bearing and viewingAngle properties of this camera to zero defaults (i.e., directly facing the Earth's surface, with the top of the screen pointing north).

+ (instancetype) cameraWithLatitude: (CLLocationDegrees)  latitude
longitude: (CLLocationDegrees)  longitude
zoom: (float)  zoom 

Convenience constructor for GMSCameraPosition, as per cameraWithTarget:zoom:.

+ (instancetype) cameraWithTarget: (CLLocationCoordinate2D)  target
zoom: (float)  zoom
bearing: (CLLocationDirection)  bearing
viewingAngle: (double)  viewingAngle 

Convenience constructor for GMSCameraPosition, with all camera properties as per initWithTarget:zoom:bearing:viewingAngle:.

+ (instancetype) cameraWithLatitude: (CLLocationDegrees)  latitude
longitude: (CLLocationDegrees)  longitude
zoom: (float)  zoom
bearing: (CLLocationDirection)  bearing
viewingAngle: (double)  viewingAngle 

Convenience constructor for GMSCameraPosition, with latitude/longitude and all other camera properties as per initWithTarget:zoom:bearing:viewingAngle:.

+ (float) zoomAtCoordinate: (CLLocationCoordinate2D)  coordinate
forMeters: (CLLocationDistance)  meters
perPoints: (CGFloat)  points 

Get the zoom level at which meters distance, at given coord on Earth, correspond to the specified number of screen points.

For extremely large or small distances the returned zoom level may be smaller or larger than the minimum or maximum zoom level allowed on the camera.

This helper method is useful for building camera positions that contain specific physical areas on Earth.


Property Documentation

- (CLLocationCoordinate2D) target [read, write, assign]

Implements GMSCameraPosition.

- (float) zoom [read, write, assign]

Implements GMSCameraPosition.

- (CLLocationDirection) bearing [read, write, assign]

Implements GMSCameraPosition.

- (double) viewingAngle [read, write, assign]

Implements GMSCameraPosition.