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

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

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.

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.

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.

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.