Other Constants

An NSNumber object containing a Boolean value; specifies whether the shape of an DingiComputedShapeSource should be wrapped to accomodate coordinates with longitudes beyond −180 and 180. The default value is NO.

Setting this option to YES affects rendering performance.

This option is used with the DingiComputedShapeSource class; it is ignored when creating an DingiShapeSource object.

An NSNumber object containing a Boolean value; specifies whether the shape of an DingiComputedShapeSource should be clipped at the edge of each tile. The default value is NO.

Setting this option to YES affects rendering performance. Use this option to clip DingiPolylines and DingiPolygons at tile boundaries without artifacts.

This option is used with the DingiComputedShapeSource class; it is ignored when creating an DingiShapeSource object.

Posted by the shared DingiOfflineStorage object when an DingiOfflinePack object’s progress changes. The progress may change due to a resource being downloaded or because the pack discovers during the download that more resources are required for offline viewing. This notification is posted whenever any field in the progress property changes.

The object is the DingiOfflinePack object whose progress changed. The userInfo dictionary contains the pack’s current state in the DingiOfflinePackStateUserInfoKey key and details about the pack’s current progress in the DingiOfflinePackProgressUserInfoKey key. You may also consult the DingiOfflinePack.state and DingiOfflinePack.progress properties, which provide the same values.

If you only need to observe changes in a particular pack’s progress, you can alternatively observe KVO change notifications to the pack’s progress key path.

Posted by the shared DingiOfflineStorage object whenever an DingiOfflinePack object encounters an error while downloading. The error may be recoverable and may not warrant the user’s attention. For example, the pack’s implementation may attempt to re-request failed resources based on an exponential backoff strategy or upon the restoration of network access.

The object is the DingiOfflinePack object that encountered the error. The userInfo dictionary contains the error object in the DingiOfflinePackErrorUserInfoKey key.

Posted by the shared DingiOfflineStorage object when the maximum number of tiles has been downloaded and stored on the current device.

The object is the DingiOfflinePack object that reached the tile limit in the course of downloading. The userInfo dictionary contains the tile limit in the DingiOfflinePackMaximumCountUserInfoKey key.

Once this limit is reached, no instance of DingiOfflinePack can download additional tiles from Dingi APIs until already downloaded tiles are removed by calling the -[DingiOfflineStorage removePack:withCompletionHandler:] method. Contact your Dingi sales representative to have the limit raised.

The key for an NSNumber object that indicates an offline pack’s current state. This key is used in the userInfo dictionary of an DingiOfflinePackProgressChangedNotification notification. Call -integerValue on the object to receive the DingiOfflinePackState-typed state.

The key for an NSValue object that indicates an offline pack’s current progress. This key is used in the userInfo dictionary of an DingiOfflinePackProgressChangedNotification notification. Call -DingiOfflinePackProgressValue on the object to receive the DingiOfflinePackProgress-typed progress.

The key for an NSError object that is encountered in the course of downloading an offline pack. This key is used in the userInfo dictionary of an DingiOfflinePackErrorNotification notification. The error’s domain is DingiErrorDomain. See DingiErrorCode for possible error codes.

The key for an NSNumber object that indicates the maximum number of Dingi-hosted tiles that may be downloaded and stored on the current device. This key is used in the userInfo dictionary of an DingiOfflinePackMaximumDingiTilesReachedNotification notification. Call -unsignedLongLongValue on the object to receive the uint64_t-typed tile limit.

An NSNumber object containing an unsigned integer that specifies the encoding formula for raster-dem tilesets. The integer corresponds to one of the constants described in DingiDEMEncoding.

The default value for this option is DingiDEMEncodingMapbox.

This option cannot be represented in a TileJSON or style JSON file. It is used with the DingiRasterDEMSource class and is ignored when creating an DingiRasterTileSource or DingiVectorTileSource object.

An NSNumber object containing a floating-point number that specifies the width and height (measured in points) at which the map displays each raster image tile when the map’s zoom level is an integer. The raster tile source scales its images up or down when the map’s zoom level falls between two integers.

The default value for this option is 512. Version 4 of the Mapbox Maps API requires a value of 256, as do many third-party tile servers, so consult your provider’s documentation for the correct value.

This option is only applicable to DingiRasterTileSource objects; it is ignored when initializing DingiVectorTileSource objects.

An NSNumber object containing a Boolean enabling or disabling clustering. If the shape property contains point shapes, setting this option to YES clusters the points by radius into groups. The default value is NO.

This option only affects point features within an DingiShapeSource object; it is ignored when creating an DingiComputedShapeSource object.

An NSNumber object containing an integer; specifies the radius of each cluster if clustering is enabled. A value of 512 produces a radius equal to the width of a tile. The default value is 50.

This option only affects point features within an DingiShapeSource object; it is ignored when creating an DingiComputedShapeSource object.

An NSNumber object containing an integer; specifies the maximum zoom level at which to cluster points if clustering is enabled. Defaults to one zoom level less than the value of DingiShapeSourceOptionMaximumZoomLevel so that, at the maximum zoom level, the shapes are not clustered.

This option only affects point features within an DingiShapeSource object; it is ignored when creating an DingiComputedShapeSource object.

An NSNumber object containing an integer; specifies the minimum zoom level at which to create vector tiles. The default value is 0.

An NSNumber object containing an integer; specifies the maximum zoom level at which to create vector tiles. A greater value produces greater detail at high zoom levels. The default value is 18.

An NSNumber object containing an integer; specifies the size of the tile buffer on each side. A value of 0 produces no buffer. A value of 512 produces a buffer as wide as the tile itself. Larger values produce fewer rendering artifacts near tile edges and slower performance. The default value is 128.

An NSNumber object containing a double; specifies the Douglas-Peucker simplification tolerance. A greater value produces simpler geometries and improves performance. The default value is 0.375.

An NSNumber object containing a Boolean enabling or disabling calculating line distance metrics.

Set this property to YES in order for the DingiLineStyleLayer.lineGradient property to have its intended effect. The default value is NO.

A version number identifying the default version of the Mapbox Streets style obtained through the -streetsStyleURL method. This version number may also be passed into the -streetsStyleURLWithVersion: method.

The value of this constant generally corresponds to the latest released version as of the date on which this SDK was published. You can use this constant to ascertain the style used by DingiMapView and DingiTilePyramidOfflineRegion when no style URL is specified. Consult the Mapbox Styles API documentation for the most up-to-date style versioning information.

An NSNumber object containing an unsigned integer that specifies the minimum zoom level at which to display tiles from the source.

The value should be between 0 and 22, inclusive, and less than DingiTileSourceOptionMaximumZoomLevel, if specified. The default value for this option is 0.

This option corresponds to the minzoom key in the TileJSON specification.

An NSNumber object containing an unsigned integer that specifies the maximum zoom level at which to display tiles from the source.

The value should be between 0 and 22, inclusive, and less than DingiTileSourceOptionMinimumZoomLevel, if specified. The default value for this option is 22.

This option corresponds to the maxzoom key in the TileJSON specification.

An NSValue object containing an DingiCoordinateBounds struct that specifies the geographic extent of the source.

If this option is specified, the SDK avoids requesting any tile that falls outside of the coordinate bounds. Otherwise, the SDK requests any tile needed to cover the viewport, as it does by default.

This option corresponds to the bounds key in the TileJSON specification.

An HTML string defining the buttons to be displayed in an action sheet when the source is part of a map view’s style and the map view’s attribution button is pressed.

By default, no attribution statements are displayed. If the DingiTileSourceOptionAttributionInfos option is specified, this option is ignored.

This option corresponds to the attribution key in the TileJSON specification.

An array of DingiAttributionInfo objects defining the buttons to be displayed in an action sheet when the source is part of a map view’s style and the map view’s attribution button is pressed.

By default, no attribution statements are displayed.

An NSNumber object containing an unsigned integer that specifies the tile coordinate system for the source’s tile URLs. The integer corresponds to one of the constants described in DingiTileCoordinateSystem.

The default value for this option is DingiTileCoordinateSystemXYZ.

This option corresponds to the scheme key in the TileJSON specification.

Indicates an error occurred in the Mapbox SDK.

An NSString identifying the linear interpolation type in an NSExpression.

This attribute corresponds to the linear value in the interpolate expression operator in the Mapbox Style Specification.

An NSString identifying the expotential interpolation type in an NSExpression.

This attribute corresponds to the exponential value in the interpolate expression operator in the Mapbox Style Specification.

An NSString identifying the cubic-bezier interpolation type in an NSExpression.

This attribute corresponds to the cubic-bezier value in the interpolate expression operator in the Mapbox Style Specification.

Project version number for Mapbox.

Project version string for Mapbox.

The default deceleration rate for a map view.

A fast deceleration rate for a map view.

Disables deceleration in a map view.

The default frame rate. This can be either 30 FPS or 60 FPS, depending on device capabilities.

A conservative frame rate; typically 30 FPS.

The maximum supported frame rate; typically 60 FPS.