MapboxSearchController Class Reference

MapboxSearchController

public class MapboxSearchController : UIViewController

extension MapboxSearchController: SearchEngineDelegate

Provides built-in location search functionality powered by Mapbox

searchBarPlaceholder
Custom search bar placeholder
Declaration
Swift

public var searchBarPlaceholder: String? { get set }
favoritesProvider
Provider of customer’s favorite records
Declaration
Swift

public var favoritesProvider: FavoritesProvider
historyProvider
Provider of recent searches
Declaration
Swift

public var historyProvider: HistoryProvider
categorySearchEngine
Actual CategorySearchEngine used for category search requests
Declaration
Swift

public var categorySearchEngine: CategorySearchEngine
searchEngine
Actual SearchEngine used for query-based searches
Declaration
Swift

public var searchEngine: SearchEngine { get set }
searchOptions
Options used to customize search, nil by default.
Declaration
Swift

public var searchOptions: SearchOptions?
categorySearchOptions
Options used to customize category search, nil by default.
Declaration
Swift

public var categorySearchOptions: SearchOptions?
configuration
Structure to configure MapboxSearchController UI and logic
Declaration
Swift

public var configuration: Configuration { get set }
delegate
The object that the search controller calls with the result of user actions
Declaration
Swift

public weak var delegate: SearchControllerDelegate?


                    
                    
                    init(accessToken:configuration:)

Instantiate MapboxSearchController with explicit accessToken and custom location provider

Declaration

Swift

public required init(accessToken: String, configuration: Configuration = Configuration())

Parameters

`accessToken`	Mapbox public access token. Checkout `init(locationProvider:)` to
`configuration`	configuration for search and categorySearch engines.


                    
                    
                    init(configuration:)

MapboxSearchController initializer with accessToken taken from application Info.plist

Access token is expected to be at MGLMapboxAccessToken key in application Info.plist. Missing accessToken will trigger fatalError

Declaration

Swift

public required init(configuration: Configuration = Configuration())

Parameters


                                  configuration

configuration for search and categorySearch engines.

viewDidLoad()
Make initial UI
Declaration
Swift

override public func viewDidLoad()
viewWillAppear(_:)
Restart listening services on screen appearance
Declaration
Swift

override public func viewWillAppear(_ animated: Bool)
viewDidDisappear(_:)
Pause listening services on screen disappearance
Declaration
Swift

override public func viewDidDisappear(_ animated: Bool)
PresentationStyle
Presentation styles for MapboxSearchController. Non-animated
See more
Declaration
Swift

public enum PresentationStyle
panelController
Get access to the MapboxPanelController for .panel presentation style
Declaration
Swift

public var panelController: MapboxPanelController? { get }


                    
                    
                    present(in:presentationStyle:)

Show Mapbox Search Controller inside of target view controller

Declaration

Swift

public func present(in rootVC: UIViewController, presentationStyle: PresentationStyle = .panel)

Parameters

`rootVC`	ViewController to be root of Search Controller
`presentationStyle`	Choose one of the presentation styles. Default is `.panel`


                    
                    
                    resetSearchUI(animated:collapse:)

Reset MapboxSearchController state recursively

Declaration

Swift

public func resetSearchUI(animated: Bool, collapse: MapboxPanelController.State? = .collapsed)

Parameters

`animated`	Should changes be animated
`collapse`	Change the collapsing status. Pass `nil` to not apply status changes. Default: `.collapsed`

Search Engine Delegate

suggestionsUpdated(suggestions:searchEngine:)
Update suggestion table or show empty suggestions view.
Declaration
Swift

public func suggestionsUpdated(suggestions: [SearchSuggestion], searchEngine: SearchEngine)


                    
                    
                    offlineResultsUpdated(_:suggestions:searchEngine:)

Declaration

Swift

public func offlineResultsUpdated(
    _ results: [SearchResult],
    suggestions: [SearchSuggestion],
    searchEngine: SearchEngine
)

resultResolved(result:searchEngine:)
Preserve result in the historyProvider and pass object to the delegate.
Declaration
Swift

public func resultResolved(result: SearchResult, searchEngine: SearchEngine)
searchErrorHappened(searchError:searchEngine:)
Display search error on results table view.
Declaration
Swift

public func searchErrorHappened(searchError: SearchError, searchEngine: SearchEngine)