Skip to content
Pull request Compare This branch is 4 commits ahead, 57 commits behind master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
server @ 46c5247


A thread-safe, Java HttpClient used to interface with the SimpleGeo Places and Context API. Both synchronous and asynchronous calls are provided.


Version 2.0 of this client is non-backwards compatible. It was deemed that in order to better serve the community, the library needed a near complete rewrite to make it more conducive to asynchronous programming. Older versions of the client are still available by selecting a 1.x tag from the drop down.

We hope you find this version of the client much more useful than the 1.0 release.

Getting Started

For network tests to succeed, you'll want to clone and start the mock SimpleGeo server:

$ git submodule update --init
$ ruby -rubygems server/server.rb

If it worked, it should say something like:

== Sinatra/1.1.0 has taken the stage on 4567 for development with backup from Mongrel

If it failed, install the dependencies and try again:

$ sudo gem install oauth json sinatra

To actually run the tests in Eclipse, navigate to the tests/src folder, right click, Run As, JUnit Tests.


There are four sets of jar ant tasks included in build.xml. There are 2 jar tasks for each of the Places client, Context client Storage client and all. One task is for building the clients without any of the supporting libs and the other includes the libs. They are:

  • jar-with-libs (includes both clients and supporting libs)
  • jar-without-libs (includes both clients but no supporting libs)
  • places-jar-with-libs (includes places client and supporting libs)
  • places-jar-without-libs (includes places client but no supporting libs)
  • context-jar-with-libs (includes context client and supporting libs)
  • context-jar-without-libs (includes context client but no supporting libs)
  • storage-jar-with-libs (includes storage client and supporting libs)
  • storage-jar-without-libs (includes storage client but no supporting libs)

After running the ant task you require, your jar will be located in the bin/ folder.

Adding to a Java/Android project


Right click (ctrl + click) on your project -> Build Path -> Configure Build Path -> Select the Libraries tab -> Add JARs (if the SimpleGeo jar is in your workspace)/Add External JARs (if the SimpleGeo jar is on your filesystem) -> Navigate to the jar you want to add and click OK. The jar has been added to your project and you can start using it by getting an instance and setting your OAuth Token like so:

$ SimpleGeoPlacesClient placesClient = SimpleGeoPlacesClient.getInstance();
$ placesClient.getHttpClient().setToken("oauth-key", "oauth-secret");


The docs are generated using javadoc and are updated as often as possible in the gh-pages branch of this repository. You can view them here

Copyright (C) 2011 SimpleGeo Inc. All rights reserved.

Something went wrong with that request. Please try again.