Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Foursquare API v2 for iOS
Objective-C
branch: master

This branch is 3 commits ahead, 39 commits behind gooichi:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
BZFoursquare
bzfoursquare_1.0_iphoneos-arm
LICENSE
README.md

README.md

Foursquare API v2 for iOS

A simple Objective-C wrapper for Version 2 of the Foursquare API. 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

This library requires your app to link against the following frameworks:

  • Foundation.framework
  • MobileCoreServices.framework
  • UIKit.framework

Uses H2CO3's CarbonateJSON for JSON parsing.

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. 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. Simply add this switch to CFLAGS and LDFLAGS in the Makefile.

  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

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.