[core] remove trailing whitespace, add trailing newlines, add space after //

1 files changed, 149 insertions, 149 deletions

diff --git a/platform/ios/src/MGLMapView.h b/platform/ios/src/MGLMapView.h
index 1f2031e055..f1670ec49f 100644
--- a/platform/ios/src/MGLMapView.h
+++ b/platform/ios/src/MGLMapView.h
@@ -47,11 +47,11 @@ typedef NS_ENUM(NSUInteger, MGLAnnotationVerticalAlignment) {
 /**
  An interactive, customizable map view with an interface similar to the one
  provided by Apple’s MapKit.
- 
+
  Using `MGLMapView`, you can embed the map inside a view, allow users to
  manipulate it with standard gestures, animate the map between different
  viewpoints, and present information in the form of annotations and overlays.
- 
+
  The map view loads scalable vector tiles that conform to the
  <a href="https://github.com/mapbox/vector-tile-spec">Mapbox Vector Tile Specification</a>.
  It styles them with a style that conforms to the
@@ -59,26 +59,26 @@ typedef NS_ENUM(NSUInteger, MGLAnnotationVerticalAlignment) {
  Such styles can be designed in
  <a href="https://www.mapbox.com/studio/">Mapbox Studio</a> and hosted on
  mapbox.com.
- 
+
  A collection of Mapbox-hosted styles is available through the `MGLStyle`
  class. These basic styles use
  <a href="https://www.mapbox.com/developers/vector-tiles/mapbox-streets">Mapbox Streets</a>
  or <a href="https://www.mapbox.com/satellite/">Mapbox Satellite</a> data
  sources, but you can specify a custom style that makes use of your own data.
- 
+
  Mapbox-hosted vector tiles and styles require an API access token, which you
  can obtain from the
  <a href="https://www.mapbox.com/studio/account/tokens/">Mapbox account page</a>.
  Access tokens associate requests to Mapbox’s vector tile and style APIs with
  your Mapbox account. They also deter other developers from using your styles
  without your permission.
- 
+
  Adding your own gesture recognizer to `MGLMapView` will block the corresponding
  gesture recognizer built into `MGLMapView`. To avoid conflicts, define which
  gesture takes precedence. For example, you can create your own
  `UITapGestureRecognizer` that will be invoked only if the default `MGLMapView`
  tap gesture fails:
- 
+
  ```swift
  let mapTapGestureRecognizer = UITapGestureRecognizer(target: self, action: #selector(myCustomFunction))
  for recognizer in mapView.gestureRecognizers! where recognizer is UITapGestureRecognizer {
@@ -86,7 +86,7 @@ typedef NS_ENUM(NSUInteger, MGLAnnotationVerticalAlignment) {
  }
  mapView.addGestureRecognizer(mapTapGestureRecognizer)
  ```
- 
+
  @note You are responsible for getting permission to use the map data and for
  ensuring that your use adheres to the relevant terms of use.
 
@@ -99,7 +99,7 @@ IB_DESIGNABLE
 /**
  Initializes and returns a newly allocated map view with the specified frame
  and the default style.
- 
+
  @param frame The frame for the view, measured in points.
  @return An initialized map view.
  */
@@ -108,7 +108,7 @@ IB_DESIGNABLE
 /**
  Initializes and returns a newly allocated map view with the specified frame
  and style URL.
- 
+
  @param frame The frame for the view, measured in points.
  @param styleURL URL of the map style to display. The URL may be a full HTTP
     or HTTPS URL, a Mapbox URL indicating the style’s map ID
@@ -122,7 +122,7 @@ IB_DESIGNABLE
 
 /**
  The receiver’s delegate.
- 
+
  A map view sends messages to its delegate to notify it of changes to its
  contents or the viewpoint. The delegate also provides information about
  annotations displayed on the map, such as the styles to apply to individual
@@ -134,17 +134,17 @@ IB_DESIGNABLE
 
 /**
  The style currently displayed in the receiver.
- 
+
  Unlike the `styleURL` property, this property is set to an object that allows
  you to manipulate every aspect of the style locally.
- 
+
  If the style is loading, this property is set to `nil` until the style finishes
  loading. If the style has failed to load, this property is set to `nil`.
  Because the style loads asynchronously, you should manipulate it in the
  `-[MGLMapViewDelegate mapView:didFinishLoadingStyle:]` or
  `-[MGLMapViewDelegate mapViewDidFinishLoadingMap:]` method. It is not possible
  to manipulate the style before it has finished loading.
- 
+
  @note The default styles provided by Mapbox contain sources and layers with
     identifiers that will change over time. Applications that use APIs that
     manipulate a style's sources and layers must first set the style URL to an
@@ -156,7 +156,7 @@ IB_DESIGNABLE
 
 /**
  URLs of the styles bundled with the library.
- 
+
  @deprecated Call the relevant class method of `MGLStyle` for the URL of a
     particular default style.
  */
@@ -164,14 +164,14 @@ IB_DESIGNABLE
 
 /**
  URL of the style currently displayed in the receiver.
- 
+
  The URL may be a full HTTP or HTTPS URL, a Mapbox URL indicating the style’s
  map ID (`mapbox://styles/{user}/{style}`), or a path to a local file
  relative to the application’s resource path.
- 
+
  If you set this property to `nil`, the receiver will use the default style
  and this property will automatically be set to that style’s URL.
- 
+
  If you want to modify the current style without replacing it outright, or if
  you want to introspect individual style attributes, use the `style` property.
  */
@@ -179,12 +179,12 @@ IB_DESIGNABLE
 
 /**
  Reloads the style.
- 
+
  You do not normally need to call this method. The map view automatically
  responds to changes in network connectivity by reloading the style. You may
  need to call this method if you change the access token after a style has
  loaded but before loading a style associated with a different Mapbox account.
- 
+
  This method does not bust the cache. Even if the style has recently changed on
  the server, calling this method does not necessarily ensure that the map view
  reflects those changes.
@@ -199,7 +199,7 @@ IB_DESIGNABLE
 
 /**
  The Mapbox logo, positioned in the lower-left corner.
- 
+
  @note The Mapbox terms of service, which governs the use of Mapbox-hosted
     vector tiles and styles,
     <a href="https://www.mapbox.com/help/mapbox-logo/">requires</a> most Mapbox
@@ -208,10 +208,10 @@ IB_DESIGNABLE
  */
 @property (nonatomic, readonly) UIImageView *logoView;
 
-/** 
+/**
  A view showing legally required copyright notices and telemetry settings,
  positioned at the bottom-right of the map view.
- 
+
  @note The Mapbox terms of service, which governs the use of Mapbox-hosted
     vector tiles and styles,
     <a href="https://www.mapbox.com/help/attribution/">requires</a> these
@@ -242,16 +242,16 @@ IB_DESIGNABLE
 
 /**
  A Boolean value indicating whether the map may display the user location.
- 
+
  Setting this property to `YES` causes the map view to use the Core Location
  framework to find the current location. As long as this property is `YES`, the
  map view continues to track the user’s location and update it periodically.
- 
+
  This property does not indicate whether the user’s position is actually visible
  on the map, only whether the map view is allowed to display it. To determine
  whether the user’s position is visible, use the `userLocationVisible` property.
  The default value of this property is `NO`.
- 
+
  On iOS 8 and above, your app must specify a value for
  `NSLocationWhenInUseUsageDescription` or `NSLocationAlwaysUsageDescription` in
  its `Info.plist` to satisfy the requirements of the underlying Core Location
@@ -259,10 +259,10 @@ IB_DESIGNABLE
  */
 @property (nonatomic, assign) BOOL showsUserLocation;
 
-/** 
+/**
  A Boolean value indicating whether the device’s current location is visible in
  the map view.
- 
+
  Use `showsUserLocation` to control the visibility of the on-screen user
  location annotation.
  */
@@ -273,10 +273,10 @@ IB_DESIGNABLE
  */
 @property (nonatomic, readonly, nullable) MGLUserLocation *userLocation;
 
-/** 
+/**
  The mode used to track the user location. The default value is
  `MGLUserTrackingModeNone`.
- 
+
  Changing the value of this property updates the map view with an animated
  transition. If you don’t want to animate the change, use the
  `-setUserTrackingMode:animated:` method instead.
@@ -285,7 +285,7 @@ IB_DESIGNABLE
 
 /**
  Sets the mode used to track the user location, with an optional transition.
- 
+
  @param mode The mode used to track the user location.
  @param animated If `YES`, there is an animated transition from the current
     viewport to a viewport that results from the change to `mode`. If `NO`, the
@@ -298,7 +298,7 @@ IB_DESIGNABLE
 /**
  The vertical alignment of the user location annotation within the receiver. The
  default value is `MGLAnnotationVerticalAlignmentCenter`.
- 
+
  Changing the value of this property updates the map view with an animated
  transition. If you don’t want to animate the change, use the
  `-setUserLocationVerticalAlignment:animated:` method instead.
@@ -308,7 +308,7 @@ IB_DESIGNABLE
 /**
  Sets the vertical alignment of the user location annotation within the
  receiver, with an optional transition.
- 
+
  @param alignment The vertical alignment of the user location annotation.
  @param animated If `YES`, the user location annotation animates to its new
     position within the map view. If `NO`, the user location annotation
@@ -325,17 +325,17 @@ IB_DESIGNABLE
 /**
  The geographic coordinate that is the subject of observation as the user
  location is being tracked.
- 
+
  By default, this property is set to an invalid coordinate, indicating that
  there is no target. In course tracking mode, the target forms one of two foci
  in the viewport, the other being the user location annotation. Typically, this
  property is set to a destination or waypoint in a real-time navigation scene.
  As the user annotation moves toward the target, the map automatically zooms in
  to fit both foci optimally within the viewport.
- 
+
  This property has no effect if the `userTrackingMode` property is set to a
  value other than `MGLUserTrackingModeFollowWithCourse`.
- 
+
  Changing the value of this property updates the map view with an animated
  transition. If you don’t want to animate the change, use the
  `-setTargetCoordinate:animated:` method instead.
@@ -345,17 +345,17 @@ IB_DESIGNABLE
 /**
  Sets the geographic coordinate that is the subject of observation as the user
  location is being tracked, with an optional transition animation.
- 
+
  By default, the target coordinate is set to an invalid coordinate, indicating
  that there is no target. In course tracking mode, the target forms one of two
  foci in the viewport, the other being the user location annotation. Typically,
  the target is set to a destination or waypoint in a real-time navigation scene.
  As the user annotation moves toward the target, the map automatically zooms in
  to fit both foci optimally within the viewport.
- 
+
  This method has no effect if the `userTrackingMode` property is set to a value
  other than `MGLUserTrackingModeFollowWithCourse`.
- 
+
  @param targetCoordinate The target coordinate to fit within the viewport.
  @param animated If `YES`, the map animates to fit the target within the map
     view. If `NO`, the map fits the target instantaneously.
@@ -367,11 +367,11 @@ IB_DESIGNABLE
 /**
  A Boolean value that determines whether the user may zoom the map in and
  out, changing the zoom level.
- 
+
  When this property is set to `YES`, the default, the user may zoom the map
  in and out by pinching two fingers or by double tapping, holding, and moving
  the finger up and down.
- 
+
  This property controls only user interactions with the map. If you set the
  value of this property to `NO`, you may still change the map zoom
  programmatically.
@@ -381,10 +381,10 @@ IB_DESIGNABLE
 /**
  A Boolean value that determines whether the user may scroll around the map,
  changing the center coordinate.
- 
+
  When this property is set to `YES`, the default, the user may scroll the map
  by dragging or swiping with one finger.
- 
+
  This property controls only user interactions with the map. If you set the
  value of this property to `NO`, you may still change the map location
  programmatically.
@@ -394,10 +394,10 @@ IB_DESIGNABLE
 /**
  A Boolean value that determines whether the user may rotate the map,
  changing the direction.
- 
+
  When this property is set to `YES`, the default, the user may rotate the map
  by moving two fingers in a circular motion.
- 
+
  This property controls only user interactions with the map. If you set the
  value of this property to `NO`, you may still rotate the map
  programmatically.
@@ -407,14 +407,14 @@ IB_DESIGNABLE
 /**
  A Boolean value that determines whether the user may change the pitch (tilt) of
  the map.
- 
+
  When this property is set to `YES`, the default, the user may tilt the map by
  vertically dragging two fingers.
- 
+
  This property controls only user interactions with the map. If you set the
  value of this property to `NO`, you may still change the pitch of the map
  programmatically.
- 
+
  The default value of this property is `YES`.
  */
 @property(nonatomic, getter=isPitchEnabled) BOOL pitchEnabled;
@@ -434,10 +434,10 @@ IB_DESIGNABLE
 
 /**
  The geographic coordinate at the center of the map view.
- 
+
  Changing the value of this property centers the map on the new coordinate
  without changing the current zoom level.
- 
+
  Changing the value of this property updates the map view immediately. If you
  want to animate the change, use the `-setCenterCoordinate:animated:` method
  instead.
@@ -446,10 +446,10 @@ IB_DESIGNABLE
 
 /**
  Changes the center coordinate of the map and optionally animates the change.
- 
+
  Changing the center coordinate centers the map on the new coordinate without
  changing the current zoom level.
- 
+
  @param coordinate The new center coordinate for the map.
  @param animated Specify `YES` if you want the map view to scroll to the new
     location or `NO` if you want the map to display the new location
@@ -460,7 +460,7 @@ IB_DESIGNABLE
 /**
  Changes the center coordinate and zoom level of the map and optionally animates
  the change.
- 
+
  @param centerCoordinate The new center coordinate for the map.
  @param zoomLevel The new zoom level for the map.
  @param animated Specify `YES` if you want the map view to animate scrolling and
@@ -472,7 +472,7 @@ IB_DESIGNABLE
 /**
  Changes the center coordinate, zoom level, and direction of the map and
  optionally animates the change.
- 
+
  @param centerCoordinate The new center coordinate for the map.
  @param zoomLevel The new zoom level for the map.
  @param direction The new direction for the map, measured in degrees relative to
@@ -486,7 +486,7 @@ IB_DESIGNABLE
 /**
  Changes the center coordinate, zoom level, and direction of the map, calling a
  completion handler at the end of an optional animation.
- 
+
  @param centerCoordinate The new center coordinate for the map.
  @param zoomLevel The new zoom level for the map.
  @param direction The new direction for the map, measured in degrees relative to
@@ -499,13 +499,13 @@ IB_DESIGNABLE
 - (void)setCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate zoomLevel:(double)zoomLevel direction:(CLLocationDirection)direction animated:(BOOL)animated completionHandler:(nullable void (^)(void))completion;
 
 /** The zoom level of the receiver.
- 
+
  In addition to affecting the visual size and detail of features on the map,
  the zoom level affects the size of the vector tiles that are loaded. At zoom
  level 0, each tile covers the entire world map; at zoom level 1, it covers ¼
  of the world; at zoom level 2, <sup>1</sup>⁄<sub>16</sub> of the world, and
  so on.
- 
+
  Changing the value of this property updates the map view immediately. If you
  want to animate the change, use the `-setZoomLevel:animated:` method instead.
  */
@@ -513,10 +513,10 @@ IB_DESIGNABLE
 
 /**
  Changes the zoom level of the map and optionally animates the change.
- 
+
  Changing the zoom level scales the map without changing the current center
  coordinate.
- 
+
  @param zoomLevel The new zoom level for the map.
  @param animated Specify `YES` if you want the map view to animate the change
     to the new zoom level or `NO` if you want the map to display the new
@@ -550,11 +550,11 @@ IB_DESIGNABLE
 
 /**
  The heading of the map, measured in degrees clockwise from true north.
- 
+
  The value `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.
- 
+
  Changing the value of this property updates the map view immediately. If you
  want to animate the change, use the `-setDirection:animated:` method instead.
  */
@@ -562,13 +562,13 @@ IB_DESIGNABLE
 
 /**
  Changes the heading of the map and optionally animates the change.
- 
+
  @param direction The heading of the map, measured in degrees clockwise from
     true north.
  @param animated Specify `YES` if you want the map view to animate the change
     to the new heading or `NO` if you want the map to display the new
     heading immediately.
- 
+
  Changing the heading rotates the map without changing the current center
  coordinate or zoom level.
  */
@@ -581,7 +581,7 @@ IB_DESIGNABLE
 
 /**
  Resets the map to the current style’s default viewport.
- 
+
  If the style doesn’t specify a default viewport, the map resets to a minimum
  zoom level, a center coordinate of (0, 0), and a northern heading.
  */
@@ -589,7 +589,7 @@ IB_DESIGNABLE
 
 /**
  The coordinate bounds visible in the receiver’s viewport.
- 
+
  Changing the value of this property updates the receiver immediately. If you
  want to animate the change, call `-setVisibleCoordinateBounds:animated:`
  instead.
@@ -599,7 +599,7 @@ IB_DESIGNABLE
 /**
  Changes the receiver’s viewport to fit the given coordinate bounds,
  optionally animating the change.
- 
+
  @param bounds The bounds that the viewport will show in its entirety.
  @param animated Specify `YES` to animate the change by smoothly scrolling
     and zooming or `NO` to immediately display the given bounds.
@@ -609,7 +609,7 @@ IB_DESIGNABLE
 /**
  Changes the receiver’s viewport to fit the given coordinate bounds and
  optionally some additional padding on each side.
- 
+
  @param bounds The bounds that the viewport will show in its entirety.
  @param insets The minimum padding (in screen points) that will be visible
     around the given coordinate bounds.
@@ -621,7 +621,7 @@ IB_DESIGNABLE
 /**
  Changes the receiver’s viewport to fit all of the given coordinates and
  optionally some additional padding on each side.
- 
+
  @param coordinates The coordinates that the viewport will show.
  @param count The number of coordinates. This number must not be greater than
     the number of elements in `coordinates`.
@@ -635,7 +635,7 @@ IB_DESIGNABLE
 /**
  Changes the receiver’s viewport to fit all of the given coordinates and
  optionally some additional padding on each side.
- 
+
  @param coordinates The coordinates that the viewport will show.
  @param count The number of coordinates. This number must not be greater than
     the number of elements in `coordinates`.
@@ -686,7 +686,7 @@ IB_DESIGNABLE
 /**
  Moves the viewpoint to a different location with respect to the map with an
  optional transition animation.
- 
+
  @param camera The new viewpoint.
  @param animated Specify `YES` if you want the map view to animate the change to
     the new viewpoint or `NO` if you want the map to display the new viewpoint
@@ -697,7 +697,7 @@ IB_DESIGNABLE
 /**
  Moves the viewpoint to a different location with respect to the map with an
  optional transition duration and timing function.
- 
+
  @param camera The new viewpoint.
  @param duration The amount of time, measured in seconds, that the transition
     animation should take. Specify `0` to jump to the new viewpoint
@@ -711,7 +711,7 @@ IB_DESIGNABLE
 /**
  Moves the viewpoint to a different location with respect to the map with an
  optional transition duration and timing function.
- 
+
  @param camera The new viewpoint.
  @param duration The amount of time, measured in seconds, that the transition
     animation should take. Specify `0` to jump to the new viewpoint
@@ -727,10 +727,10 @@ IB_DESIGNABLE
  Moves the viewpoint to a different location using a transition animation that
  evokes powered flight and a default duration based on the length of the flight
  path.
- 
+
  The transition animation seamlessly incorporates zooming and panning to help
  the user find his or her bearings even after traversing a great distance.
- 
+
  @param camera The new viewpoint.
  @param completion The block to execute after the animation finishes.
  */
@@ -739,10 +739,10 @@ IB_DESIGNABLE
 /**
  Moves the viewpoint to a different location using a transition animation that
  evokes powered flight and an optional transition duration.
- 
+
  The transition animation seamlessly incorporates zooming and panning to help
  the user find his or her bearings even after traversing a great distance.
- 
+
  @param camera The new viewpoint.
  @param duration The amount of time, measured in seconds, that the transition
     animation should take. Specify `0` to jump to the new viewpoint
@@ -755,10 +755,10 @@ IB_DESIGNABLE
 /**
  Moves the viewpoint to a different location using a transition animation that
  evokes powered flight and an optional transition duration and peak altitude.
- 
+
  The transition animation seamlessly incorporates zooming and panning to help
  the user find his or her bearings even after traversing a great distance.
- 
+
  @param camera The new viewpoint.
  @param duration The amount of time, measured in seconds, that the transition
     animation should take. Specify `0` to jump to the new viewpoint
@@ -774,7 +774,7 @@ IB_DESIGNABLE
 
 /**
  Returns the camera that best fits the given coordinate bounds.
- 
+
  @param bounds The coordinate bounds to fit to the receiver’s viewport.
  @return A camera object centered on the same location as the coordinate
     bounds with zoom level as high (close to the ground) as possible while still
@@ -786,7 +786,7 @@ IB_DESIGNABLE
 /**
  Returns the camera that best fits the given coordinate bounds, optionally with
  some additional padding on each side.
- 
+
  @param bounds The coordinate bounds to fit to the receiver’s viewport.
  @param insets The minimum padding (in screen points) that would be visible
     around the returned camera object if it were set as the receiver’s camera.
@@ -800,17 +800,17 @@ IB_DESIGNABLE
 /**
  Returns the point in this view’s coordinate system on which to "anchor" in
  response to a user-initiated gesture.
- 
+
  For example, a pinch-to-zoom gesture would anchor the map at the midpoint of
  the pinch.
- 
+
  If the `userTrackingMode` property is not `MGLUserTrackingModeNone`, the
  user annotation is used as the anchor point.
- 
+
  Subclasses may override this method to provide specialized behavior - for
  example, anchoring on the map’s center point to provide a "locked" zooming
  mode.
- 
+
  @param gesture An anchorable user gesture.
  @return The point on which to anchor in response to the gesture.
  */
@@ -819,17 +819,17 @@ IB_DESIGNABLE
 /**
  The distance from the edges of the map view’s frame to the edges of the map
  view’s logical viewport.
- 
+
  When the value of this property is equal to `UIEdgeInsetsZero`, viewport
  properties such as `centerCoordinate` assume a viewport that matches the map
  view’s frame. Otherwise, those properties are inset, excluding part of the
  frame from the viewport. For instance, if the only the top edge is inset, the
  map center is effectively shifted downward.
- 
+
  When the map view’s superview is an instance of `UIViewController` whose
  `automaticallyAdjustsScrollViewInsets` property is `YES`, the value of this
  property may be overridden at any time.
- 
+
  Changing the value of this property updates the map view immediately. If you
  want to animate the change, use the `-setContentInset:animated:` method
  instead.
@@ -839,17 +839,17 @@ IB_DESIGNABLE
 /**
  Sets the distance from the edges of the map view’s frame to the edges of the
  map view’s logical viewport with an optional transition animation.
- 
+
  When the value of this property is equal to `UIEdgeInsetsZero`, viewport
  properties such as `centerCoordinate` assume a viewport that matches the map
  view’s frame. Otherwise, those properties are inset, excluding part of the
  frame from the viewport. For instance, if the only the top edge is inset, the
  map center is effectively shifted downward.
- 
+
  When the map view’s superview is an instance of `UIViewController` whose
  `automaticallyAdjustsScrollViewInsets` property is `YES`, the value of this
  property may be overridden at any time.
- 
+
  @param contentInset The new values to inset the content by.
  @param animated Specify `YES` if you want the map view to animate the change to
     the content inset or `NO` if you want the map to inset the content
@@ -862,7 +862,7 @@ IB_DESIGNABLE
 /**
  Converts a point in the given view’s coordinate system to a geographic
  coordinate.
- 
+
  @param point The point to convert.
  @param view The view in whose coordinate system the point is expressed.
  @return The geographic coordinate at the given point.
@@ -872,7 +872,7 @@ IB_DESIGNABLE
 /**
  Converts a geographic coordinate to a point in the given view’s coordinate
  system.
- 
+
  @param coordinate The geographic coordinate to convert.
  @param view The view in whose coordinate system the returned point should be
     expressed. If this parameter is `nil`, the returned point is expressed
@@ -886,7 +886,7 @@ IB_DESIGNABLE
 /**
  Converts a rectangle in the given view’s coordinate system to a geographic
  bounding box.
- 
+
  @param rect The rectangle to convert.
  @param view The view in whose coordinate system the rectangle is expressed.
  @return The geographic bounding box coextensive with the given rectangle.
@@ -896,7 +896,7 @@ IB_DESIGNABLE
 /**
  Converts a geographic bounding box to a rectangle in the given view’s
  coordinate system.
- 
+
  @param bounds The geographic bounding box to convert.
  @param view The view in whose coordinate system the returned rectangle should
     be expressed. If this parameter is `nil`, the returned rectangle is
@@ -908,11 +908,11 @@ IB_DESIGNABLE
 /**
  Returns the distance spanned by one point in the map view’s coordinate system
  at the given latitude and current zoom level.
- 
+
  The distance between points decreases as the latitude approaches the poles.
  This relationship parallels the relationship between longitudinal coordinates
  at different latitudes.
- 
+
  @param latitude The latitude of the geographic coordinate represented by the
     point.
  @return The distance in meters spanned by a single point.
@@ -925,7 +925,7 @@ IB_DESIGNABLE
 
 /**
  The complete list of annotations associated with the receiver. (read-only)
- 
+
  The objects in this array must adopt the `MGLAnnotation` protocol. If no
  annotations are associated with the map view, the value of this property is
  `nil`.
@@ -933,9 +933,9 @@ IB_DESIGNABLE
 @property (nonatomic, readonly, nullable) NS_ARRAY_OF(id <MGLAnnotation>) *annotations;
 
 /**
- The complete list of annotations associated with the receiver that are 
+ The complete list of annotations associated with the receiver that are
  currently visible.
- 
+
  The objects in this array must adopt the `MGLAnnotation` protocol. If no
  annotations are associated with the map view or if no annotations associated
  with the map view are currently visible, the value of this property is `nil`.
@@ -944,12 +944,12 @@ IB_DESIGNABLE
 
 /**
  Adds an annotation to the map view.
- 
- @note `MGLMultiPolyline`, `MGLMultiPolygon`, `MGLShapeCollection`, and 
-    `MGLPointCollection` objects cannot be added to the map view at this time. 
-    Any multipoint, multipolyline, multipolygon, shape or point collection 
+
+ @note `MGLMultiPolyline`, `MGLMultiPolygon`, `MGLShapeCollection`, and
+    `MGLPointCollection` objects cannot be added to the map view at this time.
+    Any multipoint, multipolyline, multipolygon, shape or point collection
     object that is specified is silently ignored.
- 
+
  @param annotation The annotation object to add to the receiver. This object
     must conform to the `MGLAnnotation` protocol. The map view retains the
     annotation object. */
@@ -957,13 +957,13 @@ IB_DESIGNABLE
 
 /**
  Adds an array of annotations to the map view.
- 
+
  @note `MGLMultiPolyline`, `MGLMultiPolygon`, and `MGLShapeCollection` objects
     cannot be added to the map view at this time. Nor can `MGLMultiPoint`
     objects that are not instances of `MGLPolyline` or `MGLPolygon`. Any
     multipoint, multipolyline, multipolygon, or shape collection objects that
     are specified are silently ignored.
- 
+
  @param annotations An array of annotation objects. Each object in the array
     must conform to the `MGLAnnotation` protocol. The map view retains each
     individual annotation object.
@@ -972,11 +972,11 @@ IB_DESIGNABLE
 
 /**
  Removes an annotation from the map view, deselecting it if it is selected.
- 
+
  Removing an annotation object dissociates it from the map view entirely,
  preventing it from being displayed on the map. Thus you would typically call
  this method only when you want to hide or delete a given annotation.
- 
+
  @param annotation The annotation object to remove. This object must conform
     to the `MGLAnnotation` protocol
  */
@@ -985,11 +985,11 @@ IB_DESIGNABLE
 /**
  Removes an array of annotations from the map view, deselecting any selected
  annotations in the array.
- 
+
  Removing annotation objects dissociates them from the map view entirely,
  preventing them from being displayed on the map. Thus you would typically
  call this method only when you want to hide or delete the given annotations.
- 
+
  @param annotations The array of annotation objects to remove. Objects in the
     array must conform to the `MGLAnnotation` protocol.
  */
@@ -998,20 +998,20 @@ IB_DESIGNABLE
 /**
  Returns an `MGLAnnotationView` if the given annotation is currently associated
  with a view, otherwise nil.
- 
- @param annotation The annotation associated with the view. 
+
+ @param annotation The annotation associated with the view.
     Annotation must conform to the `MGLAnnotation` protocol.
  */
 - (nullable MGLAnnotationView *)viewForAnnotation:(id <MGLAnnotation>)annotation;
 
 /**
  Returns a reusable annotation image object associated with its identifier.
- 
+
  For performance reasons, you should generally reuse `MGLAnnotationImage`
  objects for identical-looking annotations in your map views. Dequeueing
  saves time and memory during performance-critical operations such as
  scrolling.
- 
+
  @param identifier A string identifying the annotation image to be reused.
     This string is the same one you specify when initially returning the
     annotation image object using the `-mapView:imageForAnnotation:` method.
@@ -1022,12 +1022,12 @@ IB_DESIGNABLE
 
 /**
  Returns a reusable annotation view object associated with its identifier.
- 
+
  For performance reasons, you should generally reuse `MGLAnnotationView`
  objects for identical-looking annotations in your map views. Dequeueing
  saves time and memory during performance-critical operations such as
  scrolling.
- 
+
  @param identifier A string identifying the annotation view to be reused.
     This string is the same one you specify when initially returning the
     annotation view object using the `-mapView:viewForAnnotation:` method.
@@ -1037,12 +1037,12 @@ IB_DESIGNABLE
 - (nullable __kindof MGLAnnotationView *)dequeueReusableAnnotationViewWithIdentifier:(NSString *)identifier;
 
 /**
- Returns the list of annotations associated with the receiver that intersect with 
+ Returns the list of annotations associated with the receiver that intersect with
  the given rectangle.
- 
+
  @param rect A rectangle expressed in the map view’s coordinate system.
  @return An array of objects that adopt the `MGLAnnotation` protocol or `nil` if
-    no annotations associated with the map view are currently visible in the 
+    no annotations associated with the map view are currently visible in the
     rectangle.
  */
 - (nullable NS_ARRAY_OF(id <MGLAnnotation>) *)visibleAnnotationsInRect:(CGRect)rect;
@@ -1051,7 +1051,7 @@ IB_DESIGNABLE
 
 /**
  The currently selected annotations.
- 
+
  Assigning a new array to this property selects only the first annotation in
  the array.
  */
@@ -1059,10 +1059,10 @@ IB_DESIGNABLE
 
 /**
  Selects an annotation and displays a callout view for it.
- 
+
  If the given annotation is not visible within the current viewport, this
  method has no effect.
- 
+
  @param annotation The annotation object to select.
  @param animated If `YES`, the callout view is animated into position.
  */
@@ -1070,7 +1070,7 @@ IB_DESIGNABLE
 
 /**
  Deselects an annotation and hides its callout view.
- 
+
  @param annotation The annotation object to deselect.
  @param animated If `YES`, the callout view is animated offscreen.
  */
@@ -1080,18 +1080,18 @@ IB_DESIGNABLE
 
 /**
  Adds a single overlay object to the map.
- 
+
  To remove an overlay from a map, use the `-removeOverlay:` method.
- 
+
  @param overlay The overlay object to add. This object must conform to the
     `MGLOverlay` protocol. */
 - (void)addOverlay:(id <MGLOverlay>)overlay;
 
 /**
  Adds an array of overlay objects to the map.
- 
+
  To remove multiple overlays from a map, use the `-removeOverlays:` method.
- 
+
  @param overlays An array of objects, each of which must conform to the
     `MGLOverlay` protocol.
  */
@@ -1099,19 +1099,19 @@ IB_DESIGNABLE
 
 /**
  Removes a single overlay object from the map.
- 
+
  If the specified overlay is not currently associated with the map view, this
  method does nothing.
- 
+
  @param overlay The overlay object to remove.
  */
 - (void)removeOverlay:(id <MGLOverlay>)overlay;
 
 /**
  Removes one or more overlay objects from the map.
- 
+
  If a given overlay object is not associated with the map view, it is ignored.
- 
+
  @param overlays An array of objects, each of which conforms to the `MGLOverlay`
     protocol.
  */
@@ -1121,12 +1121,12 @@ IB_DESIGNABLE
 
 /**
  Returns an array of rendered map features that intersect with a given point.
- 
+
  This method may return features from any of the map’s style layers. To restrict
  the search to a particular layer or layers, use the
  `-visibleFeaturesAtPoint:inStyleLayersWithIdentifiers:` method. For more
  information about searching for map features, see that method’s documentation.
- 
+
  @param point A point expressed in the map view’s coordinate system.
  @return An array of objects conforming to the `MGLFeature` protocol that
     represent features in the sources used by the current style.
@@ -1136,13 +1136,13 @@ IB_DESIGNABLE
 /**
  Returns an array of rendered map features that intersect with a given point,
  restricted to the given style layers.
- 
+
  Each object in the returned array represents a feature rendered by the
  current style and provides access to attributes specified by the relevant
  <a href="https://www.mapbox.com/mapbox-gl-style-spec/#sources">tile sources</a>.
  The returned array includes features specified in vector and GeoJSON tile
  sources but does not include anything from raster, image, or video sources.
- 
+
  Only visible features are returned. For example, suppose the current style uses
  the
  <a href="https://www.mapbox.com/vector-tiles/mapbox-streets/">Mapbox Streets source</a>,
@@ -1155,22 +1155,22 @@ IB_DESIGNABLE
  other attributes). The dictionary contains only the attributes provided by the
  tile source; it does not include computed attribute values or rules about how
  the feature is rendered by the current style.
- 
+
  The returned array is sorted by z-order, starting with the topmost rendered
  feature and ending with the bottommost rendered feature. A feature that is
  rendered multiple times due to wrapping across the antimeridian at low zoom
  levels is included only once, subject to the caveat that follows.
- 
+
  Features come from tiled vector data or GeoJSON data that is converted to tiles
  internally, so feature geometries are clipped at tile boundaries and features
  may appear duplicated across tiles. For example, suppose the specified point
  lies along a road that spans the screen. The resulting array includes those
  parts of the road that lie within the map tile that contain the specified
  point, even if the road extends into other tiles.
- 
+
  To find out the layer names in a particular style, view the style in
  <a href="https://www.mapbox.com/studio/">Mapbox Studio</a>.
- 
+
  @note Layer identifiers are not guaranteed to exist across styles or different
     versions of the same style. Applications that use this API must first set the
     style URL to an explicitly versioned style using a convenience method like
@@ -1178,7 +1178,7 @@ IB_DESIGNABLE
     inspectable in Interface Builder, or a manually constructed `NSURL`. This
     approach also avoids layer identifer name changes that will occur in the default
     style’s layers over time.
- 
+
  @param point A point expressed in the map view’s coordinate system.
  @param styleLayerIdentifiers A set of strings that correspond to the names of
     layers defined in the current style. Only the features contained in these
@@ -1191,12 +1191,12 @@ IB_DESIGNABLE
 /**
  Returns an array of rendered map features that intersect with the given
  rectangle.
- 
+
  This method may return features from any of the map’s style layers. To restrict
  the search to a particular layer or layers, use the
  `-visibleFeaturesAtPoint:inStyleLayersWithIdentifiers:` method. For more
  information about searching for map features, see that method’s documentation.
- 
+
  @param rect A rectangle expressed in the map view’s coordinate system.
  @return An array of objects conforming to the `MGLFeature` protocol that
     represent features in the sources used by the current style.
@@ -1206,13 +1206,13 @@ IB_DESIGNABLE
 /**
  Returns an array of rendered map features that intersect with the given
  rectangle, restricted to the given style layers.
- 
+
  Each object in the returned array represents a feature rendered by the
  current style and provides access to attributes specified by the relevant
  <a href="https://www.mapbox.com/mapbox-gl-style-spec/#sources">tile sources</a>.
  The returned array includes features specified in vector and GeoJSON tile
  sources but does not include anything from raster, image, or video sources.
- 
+
  Only visible features are returned. For example, suppose the current style uses
  the
  <a href="https://www.mapbox.com/vector-tiles/mapbox-streets/">Mapbox Streets source</a>,
@@ -1225,12 +1225,12 @@ IB_DESIGNABLE
  dictionary contains only the attributes provided by the tile source; it does
  not include computed attribute values or rules about how the feature is
  rendered by the current style.
- 
+
  The returned array is sorted by z-order, starting with the topmost rendered
  feature and ending with the bottommost rendered feature. A feature that is
  rendered multiple times due to wrapping across the antimeridian at low zoom
  levels is included only once, subject to the caveat that follows.
- 
+
  Features come from tiled vector data or GeoJSON data that is converted to tiles
  internally, so feature geometries are clipped at tile boundaries and features
  may appear duplicated across tiles. For example, suppose the specified
@@ -1238,10 +1238,10 @@ IB_DESIGNABLE
  includes those parts of the road that lie within the map tiles covering the
  specified rectangle, even if the road extends into other tiles. The portion of
  the road within each map tile is included individually.
- 
+
  To find out the layer names in a particular style, view the style in
  <a href="https://www.mapbox.com/studio/">Mapbox Studio</a>.
- 
+
  @note Layer identifiers are not guaranteed to exist across styles or different
     versions of the same style. Applications that use this API must first set the
     style URL to an explicitly versioned style using a convenience method like
@@ -1249,7 +1249,7 @@ IB_DESIGNABLE
     inspectable in Interface Builder, or a manually constructed `NSURL`. This
     approach also avoids layer identifer name changes that will occur in the default
     style’s layers over time.
- 
+
  @param rect A rectangle expressed in the map view’s coordinate system.
  @param styleLayerIdentifiers A set of strings that correspond to the names of
     layers defined in the current style. Only the features contained in these
@@ -1263,7 +1263,7 @@ IB_DESIGNABLE
 
 /**
  The options that determine which debugging aids are shown on the map.
- 
+
  These options are all disabled by default and should remain disabled in
  released software for performance and aesthetic reasons.
  */