Other Functions

The following functions are available globally.


                    
                    
                    MGLMapPointMake

Creates a new MGLMapPoint from the given X and Y coordinates, and zoom level.

Declaration

Objective-C

static inline MGLMapPoint MGLMapPointMake(CGFloat x, CGFloat y,
                                          CGFloat zoomLevel)

Swift

func MGLMapPointMake(_ x: CGFloat, _ y: CGFloat, _ zoomLevel: CGFloat) -> MGLMapPoint

View Source on GitHub


                    
                    
                    MGLCoordinateQuadMake

Creates a new MGLCoordinateQuad structure from the given top left, bottom left, bottom right, and top right coordinates.

Declaration

Objective-C

static inline MGLCoordinateQuad MGLCoordinateQuadMake(
    CLLocationCoordinate2D topLeft, CLLocationCoordinate2D bottomLeft,
    CLLocationCoordinate2D bottomRight, CLLocationCoordinate2D topRight)

Swift

func MGLCoordinateQuadMake(_ topLeft: CLLocationCoordinate2D, _ bottomLeft: CLLocationCoordinate2D, _ bottomRight: CLLocationCoordinate2D, _ topRight: CLLocationCoordinate2D) -> MGLCoordinateQuad

View Source on GitHub

MGLCoordinateQuadFromCoordinateBounds
Creates a new MGLCoordinateQuad structure from the given MGLCoordinateBounds. The returned quad uses the bounds’ northeast coordinate as the top right, and the southwest coordinate at the bottom left.
Declaration
Objective-C

static inline MGLCoordinateQuad MGLCoordinateQuadFromCoordinateBounds(MGLCoordinateBounds bounds)
Swift

func MGLCoordinateQuadFromCoordinateBounds(_ bounds: MGLCoordinateBounds) -> MGLCoordinateQuad
View Source on GitHub


                    
                    
                    MGLStringFromCoordinateQuad

Returns a formatted string for the given coordinate quad.

Declaration

Objective-C

static inline NSString *_Nonnull MGLStringFromCoordinateQuad(
    MGLCoordinateQuad quad)

Swift

func MGLStringFromCoordinateQuad(_ quad: MGLCoordinateQuad) -> String

View Source on GitHub


                    
                    
                    MGLMapPointForCoordinate

Returns Mercator projection of a WGS84 coordinate at the specified zoom level.

Declaration

Objective-C

extern MGLMapPoint MGLMapPointForCoordinate(CLLocationCoordinate2D coordinate,
                                            double zoomLevel)

Swift

func MGLMapPointForCoordinate(_ coordinate: CLLocationCoordinate2D, _ zoomLevel: Double) -> MGLMapPoint

View Source on GitHub


                    
                    
                    MGLAltitudeForZoomLevel

Converts a map zoom level to a camera altitude.

Declaration

Objective-C

extern CLLocationDistance MGLAltitudeForZoomLevel(double zoomLevel,
                                                  CGFloat pitch,
                                                  CLLocationDegrees latitude,
                                                  CGSize size)

Swift

func MGLAltitudeForZoomLevel(_ zoomLevel: Double, _ pitch: CGFloat, _ latitude: CLLocationDegrees, _ size: CGSize) -> CLLocationDistance

Parameters

`zoomLevel`	The zoom level to convert.
`pitch`	The camera pitch, measured in degrees.
`latitude`	The latitude of the point at the center of the viewport.
`size`	The size of the viewport.

Return Value

An altitude measured in meters.

View Source on GitHub


                    
                    
                    MGLZoomLevelForAltitude

Converts a camera altitude to a map zoom level.

Declaration

Objective-C

extern double MGLZoomLevelForAltitude(CLLocationDistance altitude,
                                      CGFloat pitch, CLLocationDegrees latitude,
                                      CGSize size)

Swift

func MGLZoomLevelForAltitude(_ altitude: CLLocationDistance, _ pitch: CGFloat, _ latitude: CLLocationDegrees, _ size: CGSize) -> Double

Parameters

`altitude`	The altitude to convert, measured in meters.
`pitch`	The camera pitch, measured in degrees.
`latitude`	The latitude of the point at the center of the viewport.
`size`	The size of the viewport.

Return Value

A zero-based zoom level.

View Source on GitHub


                    
                    
                    MGLSphericalPositionMake

Creates a new MGLSphericalPosition from the given radial, azimuthal, polar.

Declaration

Objective-C

static inline MGLSphericalPosition
MGLSphericalPositionMake(CGFloat radial, CLLocationDirection azimuthal,
                         CLLocationDirection polar)

Swift

func MGLSphericalPositionMake(_ radial: CGFloat, _ azimuthal: CLLocationDirection, _ polar: CLLocationDirection) -> MGLSphericalPosition

Parameters

`radial`	The radial coordinate.
`azimuthal`	The azimuthal angle.
`polar`	The polar angle.

Return Value

Returns a MGLSphericalPosition struct containing the position attributes.

View Source on GitHub


                    
                    
                    MGLTransitionMake

Creates a new MGLTransition from the given duration and delay.

Declaration

Objective-C

static inline MGLTransition MGLTransitionMake(NSTimeInterval duration,
                                              NSTimeInterval delay)

Swift

func MGLTransitionMake(_ duration: TimeInterval, _ delay: TimeInterval) -> MGLTransition

Parameters

`duration`	The amount of time the animation should take, not including the delay.
`delay`	The amount of time in seconds to wait before beginning the animation.

Return Value

Returns a MGLTransition struct containing the transition attributes.

View Source on GitHub