Chapters
Chapters

Chapters

Hide chapters

UIKit Apprentice

Second Edition · iOS 15 · Swift 5.5 · Xcode 13

Before You Begin

Section 0: 5 chapters
Show chapters Hide chapters

Getting Started

Section 1: 8 chapters
Show chapters Hide chapters

Checklists

Section 2: 12 chapters
Show chapters Hide chapters

My Locations

Section 3: 11 chapters
Show chapters Hide chapters

Store Search

Section 4: 13 chapters
Show chapters Hide chapters

22. Get Location Data
Written by Fahim Farook

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

You are going to build MyLocations, an app that uses the Core Location framework to obtain GPS coordinates for the user’s whereabouts, Map Kit to show the user’s favorite locations on a map, the iPhone’s camera and photo library to attach photos to these locations, and finally, Core Data to store everything in a database. Phew, that’s a lot of stuff!

The finished app looks like this:

The MyLocations app
The MyLocations app

MyLocations lets you keep a list of spots that you find interesting. Go somewhere with your iPhone or iPod touch and press the “Get My Location” button to obtain GPS coordinates and the corresponding street address. Save this location along with a description and a photo in your list of favorites for reminiscing about the good old days. Think of this app as a “location album” instead of a photo album.

To make the workload easier to handle, you’ll split the project up into smaller chunks:

  1. You will first figure out how to obtain GPS coordinates from the Core Location framework and how to convert these coordinates into an address, a process known as reverse geocoding. Core Location makes this easy, but due to the unpredictable nature of mobile devices, the logic involved can still get quite tricky.

  2. Once you have the coordinates, you’ll create the Tag Location screen that lets users enter the details for the new location. This is a table view controller with static cells, very similar to what you’ve done previously for Checklists.

  3. You’ll store the location data into a Core Data store. For the last app you saved app data into a .plist file, which is fine for simple apps, but pro developers use Core Data. It’s not as scary as it sounds!

  4. Next, you’ll show the locations as pins on a map using the Map Kit framework.

  5. The Tag Location screen has an Add Photo button that you will connect to the iPhone’s camera and photo library so users can add snapshots to their locations.

  6. Finally, you’ll make the app look good using custom graphics. You will also add sound effects and some animations to the mix.

Of course, you are not going to do all of that at once :] In this chapter, you will do the following:

  • Get GPS Coordinates: Create a tab bar-based app and set up the UI for the first tab.
  • CoreLocation: Use the CoreLocation framework to get the user’s current location.
  • Display coordinates: Display location information on screen.

When you’re done with this chapter, the app will look like this:

The first screen of the app
The first screen of the app

Get GPS coordinates

First, you’ll create the MyLocations project in Xcode and then use the Core Location framework to find the latitude and longitude of the user’s location.

Create project

➤ Fire up Xcode and make a new project. Choose the App template.

Choosing the App template
Ygoijehd jtu Emy zaynquki

The Tabbed Interface

We are going to have a tabbed interface for MyLocations. That means that the opening screen should actually show a tab bar along the bottom of the screen. How do we go from the blank white screen to a tabbed interface?

The storyboard with Tab Bar Controller
Rpa wtebzgoimh jonc Luy Max Ximhgiqyid

Single tab application
Nazplo dad ifdbihefuol

The first tab

In this chapter, you’ll be working with just the one tab. In future chapters you’ll add two more tabs.

The tab class
Wli sum rqagv

The app only works in portrait
Zqe ubn enyz nibfs uq fuqwfeug

Changing the title of the Tab Bar Item
Jherkagd qsa deggi ah gce Kaz Luf Ayez

First tab UI

You will now design the screen for this tab. It gets two buttons and a few labels that show the user’s GPS coordinates and the street address. To save you some time, you’ll add all the outlets in one go.

@IBOutlet weak var messageLabel: UILabel!
@IBOutlet weak var latitudeLabel: UILabel!
@IBOutlet weak var longitudeLabel: UILabel!
@IBOutlet weak var addressLabel: UILabel!
@IBOutlet weak var tagButton: UIButton!
@IBOutlet weak var getButton: UIButton!

// MARK: - Actions
@IBAction func getLocation() {
  // do nothing yet
}
The design of the Current Location screen
Vge hecacn oq tni Budnihs Papexiiv xwnuat

The (Message Label) constraints
Jko (Wirzopa Povoz) vaszvrioqrm

Core Location

Most iOS devices have a way to let you know exactly where you are on the globe, either through communication with GPS satellites, or Wi-Fi and cell tower triangulation. The Core Location framework puts that power in your own hands.

Get your current location

Getting a location from Core Location is pretty easy, but there are some pitfalls that you need to avoid. Let’s start simple and just ask it for the current coordinates and see what happens.

import CoreLocation

class CurrentLocationViewController: UIViewController, CLLocationManagerDelegate {

let locationManager = CLLocationManager()

@IBAction func getLocation() {
  locationManager.delegate = self
  locationManager.desiredAccuracy = kCLLocationAccuracyNearestTenMeters
  locationManager.startUpdatingLocation()
}

// MARK: - CLLocationManagerDelegate
func locationManager(
  _ manager: CLLocationManager, 
  didFailWithError error: Error
) {
  print("didFailWithError \(error.localizedDescription)")
}

func locationManager(
  _ manager: CLLocationManager, 
  didUpdateLocations locations: [CLLocation]
) {
  let newLocation = locations.last!
  print("didUpdateLocations \(newLocation)")
}

Ask for permission

➤ Add the following lines to the top of getLocation():

let authStatus = locationManager.authorizationStatus
if authStatus == .notDetermined {
  locationManager.requestWhenInUseAuthorization()
  return
}
Adding a new row to Info.plist
Ihbovx u mel tuq ba Omco.cbanf

Users have to allow your app to use their location
Uloxm wucu co uxvuw ruuq obt gu ixe ydaug motikeic

didFailWithError The operation couldn’t be completed. (kCLErrorDomain error 1.)

Handle permission errors

➤ Add the following method to CurrentLocationViewController.swift:

// MARK: - Helper Methods
func showLocationServicesDeniedAlert() {
  let alert = UIAlertController(
    title: "Location Services Disabled",
    message: "Please enable location services for this app in Settings.",
    preferredStyle: .alert)

  let okAction = UIAlertAction(
    title: "OK", 
    style: .default, 
    handler: nil)
  alert.addAction(okAction)

  present(alert, animated: true, completion: nil)
}

if authStatus == .denied || authStatus == .restricted {
  showLocationServicesDeniedAlert()
  return
}
The alert that pops up when location services are not available
Jve ewopt cgil kugj ed lduf keqeceot xeqqiwoz aju bek uleorecka

Location Services in the Settings app
Roweboes Baqroxaq uh sna Munverkc ubl

didFailWithError The operation couldn’t be completed. (kCLErrorDomain error 0.)

Fake location on the simulator

➤ With the app running and the simulator selected, from the Simulator’s menu bar at the top of the screen, choose Features ▸ Location ▸ Apple.

The Simulator’s Location menu
Wti Piwusariw’b Kulipiuj fozu

didUpdateLocations <+37.33259552,-122.03031802> +/- 500.00m (speed -1.00 mps / course -1.00) @ 8/11/20, 1:16:39 PM Eastern Daylight Time
didUpdateLocations <+37.33240905,-122.03051211> +/- 65.00m (speed -1.00 mps / course -1.00) @ 8/11/20, 1:16:41 PM Eastern Daylight Time
didUpdateLocations <+37.33233141,-122.03121860> +/- 50.00m (speed -1.00 mps / course -1.00) @ 8/11/20, 1:16:48 PM Eastern Daylight Time

Asynchronous operations

Obtaining a location is an example of an asynchronous process.

Display coordinates

The locationManager(_:didUpdateLocations:) delegate method gives you an array of CLLocation objects that contain the current latitude and longitude coordinates of the user.

var location: CLLocation?

func locationManager(
  _ manager: CLLocationManager, 
  didUpdateLocations locations: [CLLocation]
) {
  . . .
  location = newLocation    // Add this
  updateLabels()            // Add this
}

func updateLabels() {
  if let location = location {
    latitudeLabel.text = String(
      format: "%.8f", 
      location.coordinate.latitude)
    longitudeLabel.text = String(
      format: "%.8f", 
      location.coordinate.longitude)
    tagButton.isHidden = false
    messageLabel.text = ""
  } else {
    latitudeLabel.text = ""
    longitudeLabel.text = ""
    addressLabel.text = ""
    tagButton.isHidden = true
    messageLabel.text = "Tap 'Get My Location' to Start"
  }
}

latitudeLabel.text = "\(location.coordinate.latitude)"

Format strings

Like string interpolation, a format string uses placeholders that will be replaced by the actual value during runtime. These placeholders, or format specifiers, can be quite intricate.

String(format: "%.8f", location.coordinate.latitude)
The app shows the GPS coordinates
Zno all rwels vvu WPJ noucbuzuhip

override func viewDidLoad() {
  super.viewDidLoad()
  updateLabels()
}
What the app looks like when you start it
Nfof hpo ekb siakg kote srel woi fxobh ev

21. Swift Review
23. Use Location Data
Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2024 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now