Other Functions

The following functions are available globally.

  • 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
  • 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
  • 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
  • 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
  • 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
  • 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.

  • 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.

  • 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.

  • 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.