Foursquare API v2 for iOS
A simple Objective-C wrapper for the foursquare API v2. It allows you to integrate foursquare into your iOS application.
- Simple, small and easy to use
- Authentication using Safari (see Future Plans below)
- Asynchronous requests support
- Open source BSD license
- Xcode 5 or later
- Base SDK: iOS 7.0 or later
- Deployment Target: iOS 5.0 or later
This library requires your app to link against the following frameworks:
Register for an API consumer key
In order to obtain an oAuth access token, this library uses Safari and a custom URL scheme that brings the user back to your app. For example, FSQDemo app uses the
The client ID and callback URL are required when creating the BZFoursquare object.
BZFoursquare *foursquare = [[BZFoursquare alloc] initWithClientID:@"YOUR_CLIENT_ID" callbackURL:@"YOUR_CALLBACK_URL"];
Copy all the files from the BZFoursquare folder to your project.
Automatic Reference Counting (ARC)
If you are including this library in your project that uses Objective-C Automatic Reference Counting (ARC) enabled, you will need to set the
-fno-objc-arccompiler flag on all of the BZFoursquare source files. To do this in Xcode, go to your active target and select the "Build Phases" tab. In the "Compiler Flags" column, set
-fno-objc-arcfor each of the BZFoursquare source files. The following is the setting of the FSQDemo project.
You will need to add the MobileCoreServices library to your project. To do this in Xcode, go to your active target and select the "Build Phases" tab. In the "Link Binary with Libraries" section, click the plus button and select MobileCoreServices from the dialog box that is presented.
Set up your custom URL scheme
Add your custom URL scheme to your project. The following is the setting of the FSQDemo project.
This library comes with FSQDemo app that demonstrates authorization, making API calls to guide you in development.
To build and run FSQDemo app, open the FSQDemo project with Xcode 5 or later and set
FOURSQURE_CLIENT_ID to your client ID.
Foursquare API v2 for iOS is available under the 2-clause BSD license. See the LICENSE file for more info.
- Foursquare native authentication support