hellgheast/sprockets

Google Places API and Google Street View Image API in Java

Sprockets for Java

Query the Google Places API and Google Street View Image API in Java.

• Features
  • Google Places API
  • Google Street View Image API
• Install
• Javadoc

Google Places API

Full support for Place Search, Details, Photos, Autocomplete, and Query Autocomplete requests, including all parameters and returned fields. Getting a list of places can be as simple as:

Places.textSearch(Params.create().query("pizza near willis tower")).getResult();

More detailed searches can include lat/long with radius, specific types of places, keywords, price range, places that are open now, etc. For each returned place, you can also retrieve its full details, reviews, and photos.

The Google Places API can return a lot of information about each place and most of the time you probably won't need every detail. For maximum performance and minimum memory usage, you can specify which fields you want and limit the number of results.

Places.nearbySearch(Params.create()
        .latitude(47.60567).longitude(-122.3315).radius(5000)
        .keyword("swimming").openNow(true).maxResults(5),
        FIELD_NAME | FIELD_VICINITY | FIELD_PHOTOS).getResult();

Places Javadoc

Google Street View Image API

Download a Google Street View Image by supplying lat/long or location name.

StreetView.image(Params.create().location("18 Rue Cujas, Paris, France")).getResult();

For fine control of the camera, you can also specify the heading, pitch, and field of view.

StreetView.image(Params.create().latitude(40.748769).longitude(-73.985332)
        .heading(210).pitch(33).fov(110)).getResult();

StreetView Javadoc

Install

1. Add the dependency.

<dependency>
	<groupId>net.sf.sprockets</groupId>
	<artifactId>sprockets</artifactId>
	<version>3.0.0</version>
</dependency>

2. Add your Google API key to sprockets.xml and place it in the root of your application classpath (e.g. src/main/resources/ in a Maven project). See the Sprockets class description for more information about configuring the library settings.