vector
source defined by the style JSON file is represented at runtime by an
`MGLVectorSource` object that you can use to initialize new style layers. You
can also add and remove sources dynamically using methods such as
`-[MGLStyle addSource:]` and `-[MGLStyle sourceWithIdentifier:]`.
Within each vector tile, each geometric coordinate must lie between
−1 × extent and
(extent × 2) − 1, inclusive. Any vector style
layer initialized with a vector source must have a non-`nil` value in its
`sourceLayerIdentifier` property.
Commonly used vector sources include
Mapbox Streets,
Mapbox Terrain,
and
Mapbox Traffic.
### Example
```swift
let source = MGLVectorSource(identifier: "pois", tileURLTemplates: ["https://example.com/vector-tiles/{z}/{x}/{y}.mvt"], options: [
.minimumZoomLevel: 9,
.maximumZoomLevel: 16,
.attributionInfos: [
MGLAttributionInfo(title: NSAttributedString(string: "© Mapbox"), url: URL(string: "http://mapbox.com"))
]
])
mapView.style?.addSource(source)
```
*/
MGL_EXPORT
@interface MGLVectorSource : MGLTileSource
#pragma mark Initializing a Source
/**
Returns a vector source initialized with an identifier and configuration URL.
After initializing and configuring the source, add it to a map view’s style
using the `-[MGLStyle addSource:]` method.
The URL may be a full HTTP or HTTPS URL or, for tile sets hosted by Mapbox, a
Mapbox URL indicating a map identifier (`mapbox://http://www.example.com/tiles/{z}/{x}/{y}.pbf
could be
evaluated as http://www.example.com/tiles/14/6/9.pbf
.http://www.example.com/tiles/{z}/{x}/{y}{ratio}.png
could be
evaluated as http://www.example.com/tiles/14/6/9@2x.png
.Placeholder string | Description |
---|---|
{x} |
The index of the tile along the map’s x axis according to Spherical Mercator projection. If the value is 0, the tile’s left edge corresponds to the 180th meridian west. If the value is 2z−1, the tile’s right edge corresponds to the 180th meridian east. |
{y} |
The index of the tile along the map’s y axis according to Spherical
Mercator projection. If the value is 0, the tile’s tile edge corresponds
to arctan(sinh(π)), or approximately 85.0511 degrees north. If the value
is 2z−1, the tile’s bottom edge corresponds to
−arctan(sinh(π)), or approximately 85.0511 degrees south. The y axis is
inverted if the options parameter contains
MGLTileSourceOptionTileCoordinateSystem with a value of
MGLTileCoordinateSystemTMS . |
{z} |
The tile’s zoom level. At zoom level 0, each tile covers the entire
world map; at zoom level 1, it covers ¼ of the world; at zoom level 2,
1⁄16 of the world, and so on. For tiles loaded by
a MGLRasterSource object, whether the tile zoom level
matches the map’s current zoom level depends on the value of the
source’s tile size as specified in the
MGLTileSourceOptionTileSize key of the
options parameter. |
{bbox-epsg-3857} |
The tile’s bounding box, expressed as a comma-separated list of the tile’s western, southern, eastern, and northern extents according to Spherical Mercator (EPSG:3857) projection. The bounding box is typically used with map services conforming to the Web Map Service protocol. |
{quadkey} |
A quadkey indicating both the tile’s location and its zoom level. The quadkey is typically used with Bing Maps. |
{ratio} |
A suffix indicating the resolution of the tile image. The suffix is the
empty string for standard resolution displays and @2x for
Retina displays, including displays for which
NSScreen.backingScaleFactor or UIScreen.scale
is 3. |
{prefix} |
Two hexadecimal digits chosen such that each visible tile has a different prefix. The prefix is typically used for domain sharding. |