Foursquare for java

Foursquare4jはfoursquareのAPIをJavaから呼び出す為のライブラリです。 高速、かつコンパクトを目的としています。 Google App Engine, Android等環境での利用も可能です。 APIに関してはhttp://groups.google.com/group/foursquare-apiを参照して下さい。

OAuthを使用する場合は別途http://oauth.googlecode.comにあるoauth, oauth-consumerが必要となります。

Maven2から利用する場合

pom.xmlに下記の内容を追記して下さい。

リポジトリを追加します。

  <repositories>
  	<repository>
  		<id>foursquare4j</id>
  		<name>foursquare4j</name>
  		<url>http://foursquare4j.googlecode.com/svn/maven2</url>
  	</repository>
  </repositories>

依存関係を追加します。

  <dependencies>
    <dependency>
    	<groupId>foursquare4j</groupId>
    	<artifactId>foursquare4j</artifactId>
    	<version>0.1.3</version>
    </dependency>
    <dependency>
    	<groupId>net.oauth.core</groupId>
    	<artifactId>oauth</artifactId>
    	<version>20090531</version>
    </dependency>
    <dependency>
    	<groupId>net.oauth.core</groupId>
    	<artifactId>oauth-consumer</artifactId>
    	<version>20090823</version>
    </dependency>
  </dependencies>

サンプルコード

Basic認証を利用する場合

import foursquare4j.exception.FoursquareException;
import foursquare4j.type.Checkin;

public class Example {

	public static void main(String[] args) {

		Foursquare foursquare = new FoursquareBasicAuthenticationImpl("your@mailaddress", "password");

		try {
			for (Checkin checkin : foursquare.checkins(null, null))
				System.out.format("%s\n", checkin.getDisplay());
		} catch (FoursquareException e) {
			e.printStackTrace();
		}
	}
}

OAuthを利用する場合(AccessTokenは取得済の場合)

package foursquare4j;

import foursquare4j.exception.FoursquareException;
import foursquare4j.oauth.FoursquareOAuthImpl;
import foursquare4j.oauth.OAuthConsumer;
import foursquare4j.type.Checkin;
import foursquare4j.type.Credentials;

public class Example {

	public static void main(String[] args) {

		Credentials credentials = new Credentials();
		credentials.setAccessToken("access token.");
		credentials.setTokenSecret("token secret.");
		Foursquare foursquare = new FoursquareOAuthImpl(new OAuthConsumer("consumer key.", "consumer secret."), credentials);

		try {
			for (Checkin checkin : foursquare.checkins(null, null))
				System.out.format("%s\n", checkin.getDisplay());
		} catch (FoursquareException e) {
			e.printStackTrace();
		}
	}
}

OAuthを利用する場合(authexchange)

package foursquare4j;

import foursquare4j.exception.FoursquareException;
import foursquare4j.oauth.FoursquareOAuthImpl;
import foursquare4j.oauth.OAuthConsumer;
import foursquare4j.type.Checkin;
import foursquare4j.type.Credentials;

public class Example {

	public static void main(String[] args) {

		FoursquareOAuthImpl foursquare = new FoursquareOAuthImpl(new OAuthConsumer("consumer key.", "consumer secret."));
		try {
			// use authexchange.
			Credentials credentials = foursquare.authentication("your@emailaddress", "password");
			store(credentials);

			for (Checkin checkin : foursquare.checkins(null, null))
				System.out.format("%s\n", checkin.getDisplay());
		} catch (FoursquareException e) {
			e.printStackTrace();
		}
	}
}