GoogleNavigation Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
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.
-
Designated initializer. Configures this GMSPanoramaCamera
with orientation
, zoom
and FOV
.
These values will be clamped to acceptable ranges.
Declaration
Objective-C
- (nonnull id)initWithOrientation:(GMSOrientation)orientation
zoom:(float)zoom
FOV:(double)FOV;
-
Convenience constructor specifying heading and pitch as part of orientation
, plus zoom
and
default field of view (90 degrees).
Declaration
Objective-C
+ (nonnull instancetype)cameraWithOrientation:(GMSOrientation)orientation
zoom:(float)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;
-
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;
-
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;
-
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;
-
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;
-
The camera orientation, which groups together heading and pitch.
Declaration
Objective-C
@property (nonatomic, readonly) GMSOrientation orientation;
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003e\u003ccode\u003eGMSPanoramaCamera\u003c/code\u003e controls the viewing direction (orientation, zoom, field of view) within a \u003ccode\u003eGMSPanoramaView\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt provides various constructors to initialize the camera with desired heading, pitch, zoom, and field of view.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eFOV\u003c/code\u003e property defines the field of view, affecting the zoom effect and is clamped between 1 and 160 degrees.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ezoom\u003c/code\u003e property adjusts the visible region, with higher values zooming in and is clamped between 1 and 5.\u003c/p\u003e\n"],["\u003cp\u003eCamera orientation, encompassing heading and pitch, can be accessed through the \u003ccode\u003eorientation\u003c/code\u003e property.\u003c/p\u003e\n"]]],[],null,["# GoogleNavigation Framework Reference\n\nGMSPanoramaCamera\n=================\n\n @interface GMSPanoramaCamera : NSObject\n\n`GMSPanoramaCamera` is used to control the viewing direction of a [GMSPanoramaView](../Classes/GMSPanoramaView.html). It does not\ncontain information about which particular panorama should be displayed.\n- `\n ``\n ``\n `\n\n ### [-initWithOrientation:zoom:FOV:](#/c:objc(cs)GMSPanoramaCamera(im)initWithOrientation:zoom:FOV:)\n\n `\n ` \n Designated initializer. Configures this `GMSPanoramaCamera` with [orientation](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)orientation), [zoom](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)zoom) and [FOV](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)FOV).\n These values will be clamped to acceptable ranges. \n\n #### Declaration\n\n Swift \n\n init(orientation: ../Structs/GMSOrientation.html, zoom: Float, fov ../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)FOV: Double)\n\n Objective-C \n\n - (nonnull id)initWithOrientation:(../Structs/GMSOrientation.html)orientation\n zoom:(float)zoom\n FOV:(double)FOV;\n\n- `\n ``\n ``\n `\n\n ### [+cameraWithOrientation:zoom:](#/c:objc(cs)GMSPanoramaCamera(cm)cameraWithOrientation:zoom:)\n\n `\n ` \n Convenience constructor specifying heading and pitch as part of [orientation](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)orientation), plus [zoom](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)zoom) and\n default field of view (90 degrees). \n\n #### Declaration\n\n Swift \n\n convenience init(orientation: ../Structs/GMSOrientation.html, zoom: Float)\n\n Objective-C \n\n + (nonnull instancetype)cameraWithOrientation:(../Structs/GMSOrientation.html)orientation\n zoom:(float)zoom;\n\n- `\n ``\n ``\n `\n\n ### [+cameraWithHeading:pitch:zoom:](#/c:objc(cs)GMSPanoramaCamera(cm)cameraWithHeading:pitch:zoom:)\n\n `\n ` \n Convenience constructor specifying `heading`, `pitch`, [zoom](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)zoom) with default field of view (90\n degrees). \n\n #### Declaration\n\n Swift \n\n convenience init(heading: CLLocationDirection, pitch: Double, zoom: Float)\n\n Objective-C \n\n + (nonnull instancetype)cameraWithHeading:(CLLocationDirection)heading\n pitch:(double)pitch\n zoom:(float)zoom;\n\n- `\n ``\n ``\n `\n\n ### [+cameraWithOrientation:zoom:FOV:](#/c:objc(cs)GMSPanoramaCamera(cm)cameraWithOrientation:zoom:FOV:)\n\n `\n ` \n Convenience constructor for `GMSPanoramaCamera`, specifying all camera properties with heading\n and pitch as part of [orientation](../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)orientation). \n\n #### Declaration\n\n Objective-C \n\n + (nonnull instancetype)cameraWithOrientation:(../Structs/GMSOrientation.html)orientation\n zoom:(float)zoom\n FOV:(double)FOV;\n\n- `\n ``\n ``\n `\n\n ### [+cameraWithHeading:pitch:zoom:FOV:](#/c:objc(cs)GMSPanoramaCamera(cm)cameraWithHeading:pitch:zoom:FOV:)\n\n `\n ` \n Convenience constructor for `GMSPanoramaCamera`, specifying all camera properties. \n\n #### Declaration\n\n Swift \n\n convenience init(heading: CLLocationDirection, pitch: Double, zoom: Float, fov ../Classes/GMSPanoramaCamera.html#/c:objc(cs)GMSPanoramaCamera(py)FOV: Double)\n\n Objective-C \n\n + (nonnull instancetype)cameraWithHeading:(CLLocationDirection)heading\n pitch:(double)pitch\n zoom:(float)zoom\n FOV:(double)FOV;\n\n- `\n ``\n ``\n `\n\n ### [FOV](#/c:objc(cs)GMSPanoramaCamera(py)FOV)\n\n `\n ` \n The field of view (FOV) encompassed by the larger dimension (width or height) of the view in\n degrees at zoom 1. This is clamped to the range \\[1, 160\\] degrees, and has a default value of 90.\n\n Lower FOV values produce a zooming in effect; larger FOV values produce an fisheye effect.\n\n Note: This is not the displayed FOV if zoom is anything other than 1. User zoom gestures\n control the zoom property, not this property. \n\n #### Declaration\n\n Swift \n\n var fov: Double { get }\n\n Objective-C \n\n @property (nonatomic, readonly) double FOV;\n\n- `\n ``\n ``\n `\n\n ### [zoom](#/c:objc(cs)GMSPanoramaCamera(py)zoom)\n\n `\n ` \n Adjusts the visible region of the screen. A zoom of N will show the same area as the central\n width/N height/N area of what is shown at zoom 1.\n\n Zoom is clamped to the implementation defined range \\[1, 5\\]. \n\n #### Declaration\n\n Swift \n\n var zoom: Float { get }\n\n Objective-C \n\n @property (nonatomic, readonly) float zoom;\n\n- `\n ``\n ``\n `\n\n ### [orientation](#/c:objc(cs)GMSPanoramaCamera(py)orientation)\n\n `\n ` \n The camera orientation, which groups together heading and pitch. \n\n #### Declaration\n\n Swift \n\n var orientation: ../Structs/GMSOrientation.html { get }\n\n Objective-C \n\n @property (nonatomic, readonly) ../Structs/GMSOrientation.html orientation;"]]