+ +
+
+

MGLMapCamera

 +
+
+ 
@interface MGLMapCamera : NSObject <NSSecureCoding, NSCopying>
+ +
+
+

An MGLMapCamera object represents a viewpoint from which the user observes +some point on an MGLMapView.

+ +
+
+ +
+
+
+
    +
  • +
    + + + + centerCoordinate + +
    +
    +
    +
    +

    Coordinate at the center of the map view.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    @property (assign, readwrite, nonatomic) CLLocationCoordinate2D centerCoordinate;
    + +
    +
    +

    Swift

    + 
    var centerCoordinate: CLLocationCoordinate2D { get set }
    + +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • +
    + + + + heading + +
    +
    +
    +
    +

    Heading measured in degrees clockwise from true north.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    @property (assign, readwrite, nonatomic) CLLocationDirection heading;
    + +
    +
    +

    Swift

    + 
    var heading: CLLocationDirection { get set }
    + +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • +
    + + + + pitch + +
    +
    +
    +
    +

    Pitch toward the horizon measured in degrees, with 0 degrees resulting in a +two-dimensional map.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    @property (assign, readwrite, nonatomic) CGFloat pitch;
    + +
    +
    +

    Swift

    + 
    var pitch: CGFloat { get set }
    + +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • +
    + + + + altitude + +
    +
    +
    +
    +

    Meters above ground level.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    @property (assign, readwrite, nonatomic) CLLocationDistance altitude;
    + +
    +
    +

    Swift

    + 
    var altitude: CLLocationDistance { get set }
    + +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • +
    + + + + +camera + +
    +
    +
    +
    +

    Returns a new camera with all properties set to 0.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    + (nonnull instancetype)camera;
    + +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • + +
    +
    +
    +

    Returns a new camera using based on information about the camera’s viewpoint +and focus point.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    + (nonnull instancetype)
+cameraLookingAtCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate
+              fromEyeCoordinate:(CLLocationCoordinate2D)eyeCoordinate
+                    eyeAltitude:(CLLocationDistance)eyeAltitude;
    + +
    +
    +

    Swift

    + 
    convenience init(lookingAtCenter centerCoordinate: CLLocationCoordinate2D, fromEyeCoordinate eyeCoordinate: CLLocationCoordinate2D, eyeAltitude: CLLocationDistance)
    + +
    +
    +
    +

    Parameters

    + + + + + + + + + + + + + + + +
    + + centerCoordinate + + +
    +

    The geographic coordinate on which the map should be + centered.

    + +
    +
    + + eyeCoordinate + + +
    +

    The geometric coordinate at which the camera should be + situated.

    + +
    +
    + + eyeAltitude + + +
    +

    The altitude (measured in meters) above the map at which the + camera should be situated. The altitude may be less than the distance from + the camera’s viewpoint to the camera’s focus point.

    + +
    +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
  • + +
    +
    +
    +

    Returns a new camera with the given distance, pitch, and heading.

    + +
    +
    +

    Declaration

    +
    +

    Objective-C

    + 
    + (nonnull instancetype)
+cameraLookingAtCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate
+                   fromDistance:(CLLocationDistance)distance
+                          pitch:(CGFloat)pitch
+                        heading:(CLLocationDirection)heading;
    + +
    +
    +

    Swift

    + 
    convenience init(lookingAtCenter centerCoordinate: CLLocationCoordinate2D, fromDistance distance: CLLocationDistance, pitch: CGFloat, heading: CLLocationDirection)
    + +
    +
    +
    +

    Parameters

    + + + + + + + + + + + + + + + + + + + +
    + + centerCoordinate + + +
    +

    The geographic coordinate on which the map should be + centered.

    + +
    +
    + + distance + + +
    +

    The straight-line distance from the viewpoint to the + centerCoordinate.

    + +
    +
    + + pitch + + +
    +

    The viewing angle of the camera, measured in degrees. A value of + 0 results in a camera pointed straight down at the map. Angles greater + than 0 result in a camera angled toward the horizon.

    + +
    +
    + + heading + + +
    +

    The camera’s heading, measured in degrees clockwise from true + north. A value of 0 means that the top edge of the map view corresponds to + true north. The value 90 means the top of the map is pointing due east. + The value 180 means the top of the map points due south, and so on.

    + +
    +
    +
    +
    + + + View Source on GitHub + +
    +
    +
    +
    • +
+
+
+
+ +