https://github.com/roblabs/ios-map-ui

Using Swift to create Mapbox & MapKit Maps while minimizing reliance on storyboards
https://github.com/roblabs/ios-map-ui

ios mapbox-maps storyboards swift xcode

Last synced: 18 days ago
JSON representation

Using Swift to create Mapbox & MapKit Maps while minimizing reliance on storyboards

• Host: GitHub
• URL: https://github.com/roblabs/ios-map-ui
• Owner: roblabs
• License: mit
• Archived: true
• Created: 2017-11-20T23:40:32.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-06-18T22:50:12.000Z (almost 4 years ago)
• Last Synced: 2025-04-06T08:37:03.572Z (24 days ago)
• Topics: ios, mapbox-maps, storyboards, swift, xcode
• Language: Swift
• Homepage:
• Size: 5.76 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Using Swift to create Maps while minimizing reliance on storyboards

Explore the project at [github.com/roblabs/ios-map-ui](https://github.com/roblabs/ios-map-ui/)

# Mapbox Starter

A starter project for Mapbox maps in iOS

## Features

* A starter Mapbox project built off the steps documented at [https://www.mapbox.com/install](https://www.mapbox.com/install)

* Built using Carthage

  * `brew install carthage`

  * Install by running `carthage update`

* ~~Made with Xcode Version 9.1 (9B55), and Swift 4~~

* Updated for Xcode Version 10.3 (10G8) and Swift 5

### How to Use

* Add a `MGLMapboxAccessToken` key to the `Info.plist`.

  * See [https://www.mapbox.com/install/ios/carthage-permission](https://www.mapbox.com/install/ios/carthage-permission)

  * See [https://www.mapbox.com/help/how-access-tokens-work/](https://www.mapbox.com/help/how-access-tokens-work/)

#### Screen Shots

Initial zoom and center

![](Mapbox-starter/Mapbox-starter.png)

##### Storyboard

* Built using the option *Add with code*, so no storyboard was used in this demo.  Adding it for reference.

![](Mapbox-starter/add-with-code.png)

---

Empty Storyboard; all views added via code

![](Mapbox-starter/main.storyboard.png)

---

# Mapbox-UIBarButton

A Mapbox map with `UIBarButtonItem` added using Swift, with minimal use of the storyboard.

## Features

* Built upon Mapbox Starter

* Made with Xcode Version 9.1 (9B55), and Swift 4

* Added [`UIBarButtonItem`](https://developer.apple.com/documentation/uikit/uibarbuttonsystemitem) and code handlers to take action when they are clicked.

``` Swift

override func viewDidLoad() {

    super.viewDidLoad()

    // MARK:- UIBarButtonItem

    self.navigationItem.leftBarButtonItem = UIBarButtonItem(

        barButtonSystemItem: .search,

        target: self,

        action: #selector(handleLeftBarButton))

    self.navigationItem.rightBarButtonItem = UIBarButtonItem(

      barButtonSystemItem: .action,

      target: self,

      action: #selector(handleRightBarButton))

}

```

#### Screen Shots

Initial zoom and center

![](Mapbox-UIBarButton/Mapbox-UIBarButton.png)

##### Storyboard

* Added a [UINavigationBar](https://developer.apple.com/documentation/uikit/uinavigationbar), which is done by Embedding the view controller in Navigation Controller

  * Click your view controller

  * `Editor` > `Embed In` > `Navigation Controller`

![](Mapbox-UIBarButton/Editor.Embed-in.Navigation-Controller.png)

---

![](Mapbox-UIBarButton/main.storyboard.png)

---

# Mapbox-Search

A Mapbox map with `UISearchBar` added using Swift, with minimal use of the storyboard.

## Features

* Built upon Mapbox UIBarButtonItem

* Made with Xcode Version 9.1 (9B55), and Swift 4

* Mapbox map disappears when searching and a `UITableView` pops up with filtered search results

* The Search portion is based on the tutorial called *UISearchController Tutorial: Getting Started* from [RayWenderlich.com](https://www.raywenderlich.com/157864/uisearchcontroller-tutorial-getting-started).  Please see the license file in each file for information.

* Integrating `UISearchController` is a mixture of Storyboards and Swift code.

* Based on event handlers for when the search is started or ended, the Mapbox `mapView` is hidden or displayed.

#### Screen Shots

![](Mapbox-Search/Mapbox-Search.gif)

##### Storyboard

---

![](Mapbox-Search/main.storyboard.png)

---

# MapKit Starter

To make a MapKit view without a storyboard

1. In `Info.plist`, delete the key `Main Storyboard file base name`

1. Be sure to add the *Maps* Capability in Project > Capabilities

1. In your `AppDelegate.swift`, ```

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    window = UIWindow(frame: UIScreen.main.bounds)

    if let window = window {

        window.backgroundColor = UIColor.white

        window.rootViewController = ViewController()

        window.makeKeyAndVisible()

    }

    return true

}

```