librarything.local.getvenuesnear

Returns the LibraryThing Local data for venues near a specific location.

Authentication

This method does not require authentication.

Arguments

api_key (required)

Your API key. See your LibraryThing developer profile to get a key.

You must supply at least one of these arguments in your request.
If you supply more than one of the arguments they will be tried in the order listed here until a valid response is generated.

latlon (optional)

A latitude/longitude pair, separated by a comma

example: 30.6,-88.1

lat and lon (optional)

A latitude/longitude pair, as separate arguments

example: lat=30.6&lon=-88.1

id (optional)

A LibraryThing venue ID.
Note: you can find this number in venue URLs on the site. In the following URL the work ID is 5465:
http://www.librarything.com/venue/5465/Christopher%27s-House

example: 5465

place (optional)

The address of center of the search.
Note: This can be a verbose address, a city, a city and state, or even just a ZIP code.

example: 28 Atlantic Street, Portland, ME

example: 36693

Other optional arguments

distance (optional)

The distance to search from the center of the given location.
Default: 10

example: &distance=5

measure (optional)

The unit of measure used for distances.
The possible values are 0 for miles and 1 for kilometers
Default: 0

example: &measure=1

venueType (optional)

Used to limit the type of venues returned.
The possible values are

0: Returns all classifications of venues. This is the default type if none is supplied.
1: Returns all venues classified as bookstores.
2: Returns all venues classified as libraries.
3: Returns all venues classified as "fairs/festivals."
4: Returns all venues classified as "other."

Default: 0

example: &venueType=1

Example Request

	http://www.librarything.com/services/rest/1.1/?method=librarything.local.getvenuesnear&id=5465&apikey=d231aa37c9b4f5d304a60a3d0ad1dad4
	

Example Response

Here is an example REST response for the venue Christopher's House