API Examples

While we're excited to see all the different ways you'll think of using the nextstop API, we put together a few examples to get you started. For each example, you can view a stand-alone version by clicking on the provided link (and then view source to see what makes it tick) - please feel free to use whatever of this code you find useful. Some examples make use of jQuery although all javascript code designed to be run on external websites can be used without any additional libraries.

Hello nextstop!

This example shows a list of the top guides in Portland. Nothing fancy but a simple example of the search API.
View hello_nextstop.html »

Alternative Guide Visualization

A simple use of the guide API to render thumbnails of all the images from the guide Best Beer Bars in the World.
View alternate_guide.html »

Recommendations on a map

In this example, you can execute a query against nextstop using a simple form, and the results will be plotted on a Google Map. It includes a simple form that exposes most of the available search options for experimentation purposes.
View map_example.html »

Recommendations near you now

This uses the Google ClientLocation to identify your approximate location and shows nearby recommendations in a javascript widget.
View nearby_widget.html »

A guide as a tour

This uses the Guide API to build a map and inline visualization of a guide, including the option to connect points in the guide in either a walkable or drivable line (using the Google Maps Directions API)
View guide_map.html »

Nextstop twitterbot (@nextstopbot)

This uses the search API to provide an automated service via the twitter account @nextstopbot. Simply send a message starting with @nextstopbot that is of one of the two supported forms, and we'll tweet back with matching recommendations. Tweets can be of the form "[query] near [address]" or "[query] in [city]" for example, "@nextstopbot beers near 650 Townsend St., sf ca" or "@nextstopbot parks in san francisco". This application was built using the nextstop Search API and the Twitter API and is hosted on Google AppEngine.
Download twitterbot.zip »