[macos]Added an MGLMapView.prefetchesTiles property to configure lo… (

#14816)

* [macos]Added an `MGLMapView.prefetchesTiles` property to configure lower-resolution tile prefetching behavior

* [macos]Update changelog

platform/macos/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## master
 
+* Added an `MGLMapView.prefetchesTiles` property to configure lower-resolution tile prefetching behavior. ([#14816](https://github.com/mapbox/mapbox-gl-native/pull/14816))
+
 ### Styles and rendering
 
 * Setting `MGLMapView.contentInset` now moves the map’s focal point to the center of the content frame after insetting. ([#14664](https://github.com/mapbox/mapbox-gl-native/pull/14664))

platform/macos/src/MGLMapView.h

@@ -188,6 +188,19 @@ MGL_EXPORT IB_DESIGNABLE
  */
 @property (nonatomic, readonly) NSView *attributionView;
 
+/**
+ A Boolean value indicating whether the map should prefetch tiles.
+ 
+ When this property is set to `YES`, the map view prefetches tiles designed for
+ a low zoom level and displays them until receiving more detailed tiles for the
+ current zoom level. The prefetched tiles typically contain simplified versions
+ of each shape, improving the map view’s perceived performance.
+ 
+ The default value of this property is `YES`.
+ */
+@property (nonatomic, assign) BOOL prefetchesTiles;
+
+
 #pragma mark Manipulating the Viewpoint
 
 /**

platform/macos/src/MGLMapView.mm

@@ -654,6 +654,11 @@ - (IBAction)reloadStyle:(__unused id)sender {
     self.styleURL = styleURL;
 }
 
+- (void)setPrefetchesTiles:(BOOL)prefetchesTiles
+{
+    _mbglMap->setPrefetchZoomDelta(prefetchesTiles ? mbgl::util::DEFAULT_PREFETCH_ZOOM_DELTA : 0);
+}
+
 - (mbgl::Map *)mbglMap {
     return _mbglMap;
 }