Skip to content
This repository

Foursquare API v2 for iOS

tree: 93706c01ee

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 BZFoursquare
Octocat-spinner-32 FSQDemo
Octocat-spinner-32 images
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
README.md

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.

Features

  • Simple, small and easy to use
  • Authentication using Safari
  • Asynchronous requests support
  • Open source BSD license

Requirements

If your deployment target is set to iOS 4.3 or earlier, one of the following JSON libraries is required. If your deployment target is set to iOS 5.0 or later, it is not required.

Getting Started

  1. 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 fsqdemo URL scheme.

    FSQ Demo

    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"];
    
  2. Installation

    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-arc compiler 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-arc for each of the BZFoursquare source files. The following is the setting of the FSQDemo project.

    Compile Sources

    JSON Library

    If your deployment target is set to iOS 4.3 or earlier, JSONKit or SBJson is required. If you want to use JSONKit, you need to set the -DBZ_USE_JSONKIT=1 compiler flag on the BZFoursquareRequest source file. If you want to use SBJson, you need to set the -DBZ_USE_SBJSON=1 compiler flag on the BZFoursquareRequest source file.

  3. Set up your custom URL scheme

    Add your custom URL scheme to your project. The following is the setting of the FSQDemo project.

    URL Types

Sample Applications

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 4.2 or later and set FOURSQURE_CLIENT_ID to your client ID.

FOURSQURE\_CLIENT\_ID

License

Foursquare API v2 for iOS is available under the 2-clause BSD license. See the LICENSE file for more info.

Something went wrong with that request. Please try again.