Skip to main content

Select a feature within a layer

A newer version of the Maps SDK is available

This page uses v6.4.1 of the Mapbox Maps SDK. A newer version of the SDK is available. Learn about the latest version, v11.5.1, in the Maps SDK documentation.

import Mapbox

class ViewController: UIViewController, MGLMapViewDelegate {

var mapView: MGLMapView!
let layerIdentifier = "state-layer"

override func viewDidLoad() {

mapView = MGLMapView(frame: view.bounds)
mapView.delegate = self
mapView.setCenter(CLLocationCoordinate2D(latitude: 39.23225, longitude: -97.91015), animated: false)
mapView.autoresizingMask = [.flexibleHeight, .flexibleWidth]

// Add a single tap gesture recognizer. This gesture requires the built-in MGLMapView tap gestures (such as those for zoom and annotation selection) to fail.
let singleTap = UITapGestureRecognizer(target: self, action: #selector(handleMapTap(sender:)))
for recognizer in mapView.gestureRecognizers! where recognizer is UITapGestureRecognizer {
singleTap.require(toFail: recognizer)

func mapView(_ mapView: MGLMapView, didFinishLoading style: MGLStyle) {
// Load a tileset containing U.S. states and their population density. For more information about working with tilesets, see:
let url = URL(string: "mapbox://examples.69ytlgls")!
let source = MGLVectorTileSource(identifier: "state-source", configurationURL: url)

let layer = MGLFillStyleLayer(identifier: layerIdentifier, source: source)

// Access the tileset layer.
layer.sourceLayerIdentifier = "stateData_2-dx853g"

// Create a stops dictionary. This defines the relationship between population density and a UIColor.
let stops = [0: UIColor.yellow,

// Style the fill color using the stops dictionary, exponential interpolation mode, and the feature attribute name.
layer.fillColor = NSExpression(format: "mgl_interpolate:withCurveType:parameters:stops:(density, 'linear', nil, %@)", stops)

// Insert the new layer below the Mapbox Streets layer that contains state border lines. See the layer reference for more information about layer names:
// admin-1-boundary is available starting in mapbox-streets-v8, while admin-3-4-boundaries is provided here as a fallback for styles using older data sources.
if let symbolLayer = style.layer(withIdentifier: "admin-1-boundary") ?? style.layer(withIdentifier: "admin-3-4-boundaries") {
style.insertLayer(layer, below: symbolLayer)
} else {
fatalError("Layer with specified identifier not found in current style")

@objc @IBAction func handleMapTap(sender: UITapGestureRecognizer) {
// Get the CGPoint where the user tapped.
let spot = sender.location(in: mapView)

// Access the features at that point within the state layer.
let features = mapView.visibleFeatures(at: spot, styleLayerIdentifiers: Set([layerIdentifier]))

// Get the name of the selected state.
if let feature = features.first, let state = feature.attribute(forKey: "name") as? String {
changeOpacity(name: state)
} else {
changeOpacity(name: "")

func changeOpacity(name: String) {
guard let layer = layerIdentifier) as? MGLFillStyleLayer else {
fatalError("Could not cast to specified MGLFillStyleLayer")
// Check if a state was selected, then change the opacity of the states that were not selected.
if !name.isEmpty {
layer.fillOpacity = NSExpression(format: "TERNARY(name = %@, 1, 0)", name)
} else {
// Reset the opacity for all states if the user did not tap on a state.
layer.fillOpacity = NSExpression(forConstantValue: 1)