GoogleMaps Framework Reference

AI-generated Key Takeaways

• GMSPanoramaCamera controls the viewing direction (orientation, zoom, field of view) within a GMSPanoramaView, but not the panorama itself.

• It offers various constructors for initialization with different combinations of orientation, heading, pitch, zoom, and field of view.

• The FOV property, clamped to 1-160 degrees, sets the field of view at zoom 1, impacting the visual effect (zoom in or fisheye).

• The zoom property, clamped to 1-5, adjusts the visible region, with higher values zooming in on the central area.

• The orientation property combines heading and pitch, determining the camera's direction.

GMSPanoramaCamera

@interface GMSPanoramaCamera : NSObject

GMSPanoramaCamera is used to control the viewing direction of a GMSPanoramaView. It does not contain information about which particular panorama should be displayed.

• -initWithOrientation:zoom:FOV:

  Designated initializer. Configures this GMSPanoramaCamera with orientation, zoom and FOV. These values will be clamped to acceptable ranges.

  Declaration

  Swift

  init(orientation: GMSOrientation, zoom: Float, fov FOV: Double)

  Objective-C

  - (nonnull id)initWithOrientation:(GMSOrientation)orientation
                               zoom:(float)zoom
                                FOV:(double)FOV;

• +cameraWithOrientation:zoom:

  Convenience constructor specifying heading and pitch as part of orientation, plus zoom and default field of view (90 degrees).

  Declaration

  Swift

  convenience init(orientation: GMSOrientation, zoom: Float)

  Objective-C

  + (nonnull instancetype)cameraWithOrientation:(GMSOrientation)orientation
                                           zoom:(float)zoom;

• +cameraWithHeading:pitch:zoom:

  Convenience constructor specifying heading, pitch, zoom with default field of view (90 degrees).

  Declaration

  Swift

  convenience init(heading: CLLocationDirection, pitch: Double, zoom: Float)

  Objective-C

  + (nonnull instancetype)cameraWithHeading:(CLLocationDirection)heading
                                      pitch:(double)pitch
                                       zoom:(float)zoom;

• +cameraWithOrientation:zoom:FOV:

  Convenience constructor for GMSPanoramaCamera, specifying all camera properties with heading and pitch as part of orientation.

  Declaration

  Objective-C

  + (nonnull instancetype)cameraWithOrientation:(GMSOrientation)orientation
                                           zoom:(float)zoom
                                            FOV:(double)FOV;

• +cameraWithHeading:pitch:zoom:FOV:

  Convenience constructor for GMSPanoramaCamera, specifying all camera properties.

  Declaration

  Swift

  convenience init(heading: CLLocationDirection, pitch: Double, zoom: Float, fov FOV: Double)

  Objective-C

  + (nonnull instancetype)cameraWithHeading:(CLLocationDirection)heading
                                      pitch:(double)pitch
                                       zoom:(float)zoom
                                        FOV:(double)FOV;

• FOV

  The field of view (FOV) encompassed by the larger dimension (width or height) of the view in degrees at zoom 1. This is clamped to the range [1, 160] degrees, and has a default value of 90.

  Lower FOV values produce a zooming in effect; larger FOV values produce an fisheye effect.

  Note: This is not the displayed FOV if zoom is anything other than 1. User zoom gestures control the zoom property, not this property.

  Declaration

  Swift

  var fov: Double { get }

  Objective-C

  @property (nonatomic, readonly) double FOV;

• zoom

  Adjusts the visible region of the screen. A zoom of N will show the same area as the central width/N height/N area of what is shown at zoom 1.

  Zoom is clamped to the implementation defined range [1, 5].

  Declaration

  Swift

  var zoom: Float { get }

  Objective-C

  @property (nonatomic, readonly) float zoom;

• orientation

  The camera orientation, which groups together heading and pitch.

  Declaration

  Swift

  var orientation: GMSOrientation { get }

  Objective-C

  @property (nonatomic, readonly) GMSOrientation orientation;