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


                    
                    
                    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