iOS Programming 101: How To Get the User Location in iPhone App

128 Flares 128 Flares ×

This is the third article of the iOS Programming 101 series. In the previous two articles, we showed you how to hide the tab bar and implement email feature in your app. In this article, we’ll show you how to add GPS capability in your iPhone app and retrieve the user’s current location. We’ll even cover tip to translate the GPS coordinate into street address. It’s gonna to be fun and pretty easy to implement.

Location services provide a way to improve your app by enhancing the user experience. If you’re developing a travel app, you can base on the users’ current location to search for nearby restaurants or hotels. You can also find the location feature in most of the Photo apps that saves where the pictures are taken. The Core Location framework provides the necessary Objective-C interfaces for obtaining information about the user’s location. With the GPS coordinate obtained, you can make use of the API to decode the actual street or utilize the Map framework to further display the location on Map.

In this tutorial, we’ll build a simple app to show you how to use the Core Location framework. Here are the things we’ll do:

  • Build a simple interface to display the GPS coordinate and address
  • Learn how to use the Core Location APIs to retrieve the current location
  • Utilize the built-in APIs to translate the GPS coordinates into street address

Okay, let’s get started.

Create the Project and Design the Interface

First, create a new Xcode project using the Single View Template. Let’s name the project as “MyLocationDemo” and set the project with the following parameters:

MyLocationDemo Xcode Project

MyLocationDemo Xcode Project

Once you’ve successfully created your project, go to the Storyboard and design the user interface. In the View, add three labels for latitude, longitude and address. For each label, place another label next to it. Later we’ll use these labels to display the GPS coordinates and address. Finally, insert a button and name it as “Get My Location”. Your user interface should be similar to the one shown below.

MyLocationDemo User Interface

MyLocationDemo User Interface

For the “For Address” label, change the “lines” option from 1 to 4, as we’ll display address in multi-lines. You may also decrease the font size to 14 points in the Attribute Inspector.

MyLocation Customize Address Label

Customize Address Label

Establish the Connection Between Variables and UI Elements

Next, we’ll connect the UI elements with our code. In the Storyboard, select the view controller and switch to the Assistant Editor.

Show Assistant Editor

Show Assistant Editor and Hide Utility Area

Press and hold the control key, click the “For Latitude Value” label and drag it towards the “MyLocationViewController.h”. Place the cursor between the @interface and @end keywords, you should see a prompt that allows you to insert an outlet.

MyLocation Add Outlet to Code

Establish the Connection Between Variables and UI Elements

Name the outlet as “latitudeLabel”.

MyLocation LatitudeLabel Outlet

Create the Instance Variable and Name it as latitudeLabel

Repeat the same procedures and create the outlet for the “For Longitude Value” label and “For Address” label. Finally, create an action method for the “Get My Location” button and name it as “getCurrentLocation”. This method will be invoked when it detects a Touch Up Inside event.

MyLocation GetMyLocation Button

Create a method for Get My Location Button

If you follow us correctly, the code of MyLocationViewController.h should look like below:

1
2
3
4
5
6
7
8
9
#import <UIKit/UIKit.h>

@interface MyLocationViewController : UIViewController
@property (weak, nonatomic) IBOutlet UILabel *latitudeLabel;
@property (weak, nonatomic) IBOutlet UILabel *longitudeLabel;
@property (weak, nonatomic) IBOutlet UILabel *addressLabel;
- (IBAction)getCurrentLocation:(id)sender;

@end

Adding Core Location Framework

To retrieve the current user location, as mentioned earlier, we’ll make use of the CoreLocation framework provided by the iOS SDK. By default, however, the Core Location Framework is not bundled in any Xcode project. We have to add it manually. In the Project Navigator, select the “MyLocationDemo” project. In the Content Area, select “MyLocationDemo” under Targets and click “Build Phases”. Expand “Link Binary with Libraries” and click the “+” button to add the CoreLocation framework.

MyLocation Add New Framework

Add a new library to Your Xcode Project

MyLocationDemo Add CoreLocation

Adding CoreLocation Framework to Your Project

Jump into the Code

Let’s move onto the core part of this tutorial. Core Location framework, that you’ve just added, allows you to retrieve the user’s current location in the form of latitude and longitude. It can even give you continuous location update if the user is on the move.

Like other libraries in the iOS SDK, Core Location makes use of the delegate pattern. To work with the Core Location framework, our view controller should conform to the CLLocationManagerDelegate protocol. This protocol defines methods used to receive location and heading updates from a CLLocationManager object.

To let the view controller know about the CLLocationManagerDelegate, you first import the corresponding header file. In the “MyLocationViewController.h”, add the #import statement and implement the “CLLocationManagerDelegate”.

1
2
3
#import <CoreLocation/CoreLocation.h>

@interface MyLocationViewController : UIViewController <CLLocationManagerDelegate>

Now go to the “MyLocationViewController.m”. Declare an instance variable and name it as locationManager.

1
2
3
@implementation MyLocationViewController {
    CLLocationManager *locationManager;
}

The CLLocationManager is the object that provides you the location data.

Add the following code in the viewDidLoad method to instantiate the CLLocationManager object:

1
2
3
4
5
6
- (void)viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    locationManager = [[CLLocationManager alloc] init];
}

Once you initialize a CLLocationManager object, you can simply call the startUpdatingLocation method to the location service. The service will then continuously send your application a stream of location data.

Add the following code to the getCurrentLocation method, which is hooked up the to “Get My Location” button:

1
2
3
4
5
6
- (IBAction)getCurrentLocation:(id)sender {
    locationManager.delegate = self;
    locationManager.desiredAccuracy = kCLLocationAccuracyBest;
   
    [locationManager startUpdatingLocation];
}

As discussed earlier, the location data is reported to your app via the location manager’s associated delegate object. Here, we assign MyLocationViewController as the delegate object. All the location updates will send to the delegate. To capture the location event, we have to implement the delegate methods as defined in the protocol.

Add the following code to MyLocationViewController.m and place them right below the “getCurrentLocation” method:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
#pragma mark - CLLocationManagerDelegate

- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error
{
    NSLog(@"didFailWithError: %@", error);
    UIAlertView *errorAlert = [[UIAlertView alloc]
                                    initWithTitle:@"Error" message:@"Failed to Get Your Location" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
    [errorAlert show];
}

- (void)locationManager:(CLLocationManager *)manager didUpdateToLocation:(CLLocation *)newLocation fromLocation:(CLLocation *)oldLocation
{
    NSLog(@"didUpdateToLocation: %@", newLocation);
    CLLocation *currentLocation = newLocation;
   
    if (currentLocation != nil) {
        longitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.longitude];
        latitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.latitude];
    }
}

Test Your App with Fake Location

Now you can compile the app and test it by using the Simulator. You may wonder how you can use the iPhone Simulator to test location-aware application. How can the Simulator retrieve the current location?

There is no way for the Simulator to get the current location as your computer doesn’t have GPS built-in (even you have, Xcode won’t use it). However, the Simulator allows you to fake it.

After you launch the app, click the “Get My Location” button. For the very first time you run the app, it’ll prompt the following alert to request for the access of location manager:

MyLocationDemo Location Alert

Remember to accept it, otherwise, the app will not be able to access the location service. Oops! The app displays an error even you tap the OK button.

MyLocationDemo Fail to Get Location

Failed to get the current location

Why? By default, the Simulator doesn’t know its own location. In the menu bar, select “Debug” -> “Location”. The default location is set to “None”. That’s the reason why you get the “Fail to Get Your Location” error. Now change the location setting to “Apple” (or “Apple Stores”). Your app should now show you the latitude and longitude values.

MyLocationDemo Apple Location

Xcode offers another way to simulate location. While running the app, you can change to other locations by using the arrow button in the top bar of the debug area.

Xcode Simulate Location

Simulate Other Locations

Finding the Address

The CLGeocoder class provides services for converting between a GPS coordinate and the user-readable address of that coordinate. By specify the latitude and longitude of a given location, you can use CLGeocoder to find a user-readable address. The result (i.e. the address) returned by CLGeocoder is saved in a CLPlacemark object.

Back to your Xcode project. Add two instance variables: geocoder and placemark.

1
2
3
4
5
@implementation MyLocationViewController {
    CLLocationManager *locationManager;
    CLGeocoder *geocoder;
    CLPlacemark *placemark;
}

Initialize the “geocoder” in the “viewDidLoad” method:

1
2
3
4
5
6
7
- (void)viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    locationManager = [[CLLocationManager alloc] init];
    geocoder = [[CLGeocoder alloc] init];
}

Update the “didUpdateToLocation” method to include the code for reverse geocoding:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
- (void)locationManager:(CLLocationManager *)manager didUpdateToLocation:(CLLocation *)newLocation fromLocation:(CLLocation *)oldLocation
{
    NSLog(@"didUpdateToLocation: %@", newLocation);
    CLLocation *currentLocation = newLocation;
   
    if (currentLocation != nil) {
        longitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.longitude];
        latitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.latitude];
    }
   
    // Reverse Geocoding
    NSLog(@"Resolving the Address");
    [geocoder reverseGeocodeLocation:currentLocation completionHandler:^(NSArray *placemarks, NSError *error) {
        NSLog(@"Found placemarks: %@, error: %@", placemarks, error);
        if (error == nil && [placemarks count] > 0) {
            placemark = [placemarks lastObject];
            addressLabel.text = [NSString stringWithFormat:@"%@ %@\n%@ %@\n%@\n%@",
                                 placemark.subThoroughfare, placemark.thoroughfare,
                                 placemark.postalCode, placemark.locality,
                                 placemark.administrativeArea,
                                 placemark.country];
        } else {
            NSLog(@"%@", error.debugDescription);
        }
    } ];

}

We use the “reverseGeocodeLocation” method to translate the locate data into a human-readable address. The geocoding operations doesn’t happen on the device. The method instead submits the given data to the geocoding server in the cloud in order to resolve the address. Other than the location data, you have to provide the handler that contains code to execute after the address is resolved. In this case, we’ll update the address label to display the address on screen.

The syntax of the completionHandler may be new to you. Instead of using delegate to provide feedback, the CLGeocoder uses “block” to deal with the response. By using block, you do not need to write a separate method. Just provide the code inline to execute after the geocoding call completes.

Upon completion of a geocoding request, the completionHandler will be invoked automatically. The resolved address is saved in CLPlacemark array. Placemark data includes information such as the country, state, city, and street address. So we simply pick the CLPlacemark object from the array and show the address in the address label.

That’s it. Run the app again, pick a location (e.g. Apple) and you should get its address:

MyLocationDemo Address Resolved

Saving Battery Power

The app works but it consumes a lot of power. Why? What the app does is to retrieve the current user’s location. It shouldn’t consume much power, right?

Let’s revisit our code again. Once the user taps the “Get My Location” button, we’ll call up the “startUpdatingLocation” method to retrieve the user’s location.

1
2
3
4
5
6
- (IBAction)getCurrentLocation:(id)sender {
    locationManager.delegate = self;
    locationManager.desiredAccuracy = kCLLocationAccuracyBest;
   
    [locationManager startUpdatingLocation];
}

The problem is that the method will report the location data continuously. It just keeps going and gives location update every second, even the location is unchanged. Take a look at the output of the Debug area. You should have something similar to the below:

1
2
3
4
5
6
7
8
9
10
11
12
2012-09-09 14:32:33.940 MyLocationDemo[13690:c07] didUpdateToLocation: <+37.33240905,-122.03051211> +/- 65.00m (speed -1.00 mps / course -1.00) @ 9/9/12 2:32:33 PM Hong Kong Time
2012-09-09 14:32:33.941 MyLocationDemo[13690:c07] Resolving the Address
2012-09-09 14:32:34.793 MyLocationDemo[13690:c07] didUpdateToLocation: <+37.33240818,-122.03049049> +/- 65.00m (speed -1.00 mps / course -1.00) @ 9/9/12 2:32:34 PM Hong Kong Time
2012-09-09 14:32:34.793 MyLocationDemo[13690:c07] Resolving the Address
2012-09-09 14:32:34.997 MyLocationDemo[13690:c07] Found placemarks: (
    "Apple Inc., Apple Inc., 2 Infinite Loop, Cupertino, CA  95014-2083, United States @ <+37.33270820,-122.03033640> +/- 100.00m, region (identifier <+37.33270823,-122.03021599> radius 58.34) <+37.33270823,-122.03021599> radius 58.34m"
), error: (null)
2012-09-09 14:32:35.792 MyLocationDemo[13690:c07] didUpdateToLocation: <+37.33240773,-122.03047951> +/- 65.00m (speed -1.00 mps / course -1.00) @ 9/9/12 2:32:35 PM Hong Kong Time
2012-09-09 14:32:35.793 MyLocationDemo[13690:c07] Resolving the Address
2012-09-09 14:32:35.973 MyLocationDemo[13690:c07] Found placemarks: (
    "Apple Inc., Apple Inc., 2 Infinite Loop, Cupertino, CA  95014-2083, United States @ <+37.33270820,-122.03033640> +/- 100.00m, region (identifier <+37.33270823,-122.03021599> radius 58.34) <+37.33270823,-122.03021599> radius 58.34m"
), error: (null)

As you can see, the “didUpdateToLocation” is invoked multiple times and it just keeps going on and on.

So how can you tell the location manager to stop from updating the location? You can use the “stopUpdatingLocation” method to disable the location update. For our app, we can stop the location update once we retrieve the current location.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
- (void)locationManager:(CLLocationManager *)manager didUpdateToLocation:(CLLocation *)newLocation fromLocation:(CLLocation *)oldLocation
{
    NSLog(@"didUpdateToLocation: %@", newLocation);
    CLLocation *currentLocation = newLocation;
   
    if (currentLocation != nil) {
        longitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.longitude];
        latitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.latitude];
    }

    // Stop Location Manager
    [locationManager stopUpdatingLocation];

    NSLog(@"Resolving the Address");
    [geocoder reverseGeocodeLocation:currentLocation completionHandler:^(NSArray *placemarks, NSError *error) {
        NSLog(@"Found placemarks: %@, error: %@", placemarks, error);
        if (error == nil && [placemarks count] > 0) {
            placemark = [placemarks lastObject];
            addressLabel.text = [NSString stringWithFormat:@"%@ %@\n%@ %@\n%@\n%@",
                                 placemark.subThoroughfare, placemark.thoroughfare,
                                 placemark.postalCode, placemark.locality,
                                 placemark.administrativeArea,
                                 placemark.country];
        } else {
            NSLog(@"%@", error.debugDescription);
        }
    } ];

}

Try to run the app again and check out the output message in the output area. You should notice that the “didUpdateToLocation” is called once and stopped.

What’s Coming Next?

In this tutorial, we give you a simple demo to show how to use the Core Location framework. The app is very basic. If you’re going to develop a real app, don’t forget to handle various error cases such as network error.

So what’s next? We’ll continue to work on the demo app and display the current location in a map.

As always, leave us comment and share your thought.

You May Like These:

Get Free Chapters of Our AppCoda Book

Learn iOS 7 Programming from Scratch

The Learn iOS 7 Programming from Scratch is a 400-page eBook written for beginners with little or even no programming experience. It is based on the tutorials of our popular programming course. The book starts with the basics and walks you through the process to create iOS apps using iOS 7 SDK and Xcode 5. Want to learn more? Check it out here and get two free chapters.


Build Your Own Game and Monetize on the Side

Learn how to develop your first iOS game and make money on the side. The starter kit will come with full source code of a memory game for both iPhone and iPad, as well as, a complete guide to explain how the code works. Check out the starter kit to learn more.


  • http://twitter.com/geztogether gezt

    cool tutorial thanks

  • http://twitter.com/RodrRojas Rodrigo Rojas

    Thanks man, great Tutorial.

  • Ravi Parmar

    Really great tutorial, thanks a lot.

  • Hamid Saleemi

    Can I get the current time of the desired location from the gps coordinates ?

  • Pingback: iOS Programming 101: Intro to MapKit API and Add an Annotation on Map | iptips - iphone / ipad / ios / android / mobile / tutorials

  • David

    So cool! Thanks!!!!!

  • Pingback: iOS Programming 101: Intro to MapKit API and Add an Annotation on Map | iptips - iphone / ipad / ios / android / mobile / tutorials

  • erum

    aka please let me know how can i find distance between two locations as i m using “old location distancefromlocation newlocation” as it is running continuously and getting current location updates but pls tell me in start old location will be 0 but after that may i need to put new location in old location or it will automatically put new location data into old location and most current location will be in new location i dnt have device i dnt know how it works in device pls help me

    and how can i find speed using device w.r.t user movement

  • erum

    aka instead of aka sorry for typing

  • Malkit Singh

    great article, worth reading it….thanks…..

  • dilo

    sweet

  • http://www.sufalamtech.com/ Web Development Company

    Both the purpose property and the didUpdateToLocation method are deprecated in iOS6. It will build with didUpdateLocation but you will need to comment out the purpose assignment statement.

    • Tom

      Being new to ios coding…..
      which part is the purpose property?
      Thanks,

    • Tom

      Being new to all of this….
      which part is the purpose assignment statement?
      Thanks,

  • Asim

    hi

    i want this project can you please give me link to download it??

  • Pingback: iOS Links – Resources I Collected While Learning iOSThe PHP Coder's Judy Chop | The PHP Coder's Judy Chop

  • Foolish Foppish Fancyman

    Missing a key piece of info. Don’t forget to add @synthesize longitudeLabel, latitudeLabel, addressLabel; in the viewController.m file.

    • Matthew

      I didn’t think this was needed anymore since iOS 5 I think.

      • kushalashok

        In that case you have to use the default instance variable i.e. _latitudeLabel
        Otherwise, as mentioned by Fancyman, using @synthesize is necessary.

  • Oliverreyes

    where do the synthesize go ?
    where can i find the source code ?

  • Oliverreyes

    the thing is when you type and try to recreate the code … it does not work, making a useless 101 tutorial

  • http://twitter.com/smarterkey smarterkey

    Great introduction to CoreLocation. I used xcode 4.3.2 and the above tutorial worked fine with NO adjustments. (re:Oliverreyes)

  • Patrick CM

    good tutorial. As mentioned. the three @synthesize lines need adding, other than that it worked fine. iphone 4, IOS 6.1.2 mac mini ML OS X 10.8.2 XCode 4.6

  • sarvjeet

    nice1…thanks

  • Pranav

    very useful
    Thanks……

  • Ravikumar

    Thank you so much for providing this tutorial ………

  • npersson

    Awesome as always! Really like that you are detailed and don’t leave anything out!

  • npersson

    Having a problem with this, I only get new coordinates EVERY OTHER TIME I click the button, not every time. What’s up with that? Anyone having the same problem?

  • Dalia

    You always do very good,great and clear tutorials! Thanks for sharing with us! Keep up the good work!!

    • http://www.simonblog.com Simon Ng

      Thanks for your support. More tutorials are coming. Keep coming back!

  • Roya

    Thank you so much for this tutorial. However, I’m running into a few issues. Can you please post the source code for this one as you’re doing for the newer tutorials?

  • iosNoobie

    This is awesome, thanks! Will this return the name of business nearby or just the address?

  • Karel

    I personally was not able to get this project working on xcode 4.6.3! I was able to run the application but when I requested the location, the app halted at these lines:

    longitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.longitude];
    latitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.latitude];

    Any advice would be appreciated!

    • Commander Spock

      Just put “self.” before both of those lines. Here’s how they’ll look.

      self.longitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.longitude];

      self.latitudeLabel.text = [NSString stringWithFormat:@"%.8f", currentLocation.coordinate.latitude];

      Later on, you’ll run into a similar problem with a line that starts with “address.text.” Again, just add “self.” to the front of it to make it start with “self.address.text.”

      The “self” prefix indicates to the class that the code is referring to an instance variable defined in the class.

      Hope this helped!

    • http://www.showmyroutes.com showmyroutes

      use _latitudeLabel.text and _longitudeLable will resolve the problem.

  • Ali Afzal

    It is the very good example for learning how to use the current location in my app.

  • Guest

    Doesn’t work in current version of Xcode.

    • http://www.simonblog.com Simon Ng

      Which version of Xcode?

      • azam3d

        Xcode 5. I can’t retrieve the address but latitude and longitude value is fine.

  • Gilbert

    If the tutorial doesn’t work for you and you are getting all sorts of parse errors (like myself), try and set the deployment target to IOS 5.1 instead of 6.1…that helped for me (plus the ‘self.’ addition to the addressLabel described below).

  • ShanghaiTimes

    Brilliant. Thanks. I struggled for days with the O’Reilly book “Geolocation for iOS” – written for an XCode4 I think. anyway, I gave up on that. Followed your guide lines, and apart from having to add the underscore “_” to _longitudeLabel.text etc, it worked right out of the box. I’m using XCode5 & iOS7
    You make it so easy. Only thing I can’t get right yet, is the text in the address label. I can’t get it to wrap the lines, so that I can read it…. but hey, I have to have something to do :-)

  • muthukumar

    i got postal code and locality null. how to get postal code.

  • Pingback: New To Xcode – I'm StruggilingCopyQuery CopyQuery | Question & Answer Tool for your Technical Queries,CopyQuery, ejjuit, query, copyquery, copyquery.com, android doubt, ios question, sql query, sqlite query, nodejsquery, dns query, update q

  • rakesh jyoti

    u guys are very helpful for a trainee n i am a trainee…
    so a big big thank u for u guys.

  • E. Newton

    This was a very valuable tutorial for an Obj C beginner. You did a great job; content, presentation, format; everything!

  • Rasmus

    Very useful, thank you! Sometimes when I run the app I get a (null). Is it possible to make it so (null) never appears?

    Once again, thank you

  • Pingback: mySpiritSoupCollections | HelloHelloYe

  • http://www.imobdevtech.com/Contactus/requestForProposal iPhone APP Development

    Really great tutorial, thanks a lot.

128 Flares Twitter 16 Facebook 99 Google+ 11 LinkedIn 2 128 Flares ×