librarything.local.geteventsnear
Returns the LibraryThing Local data for events 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.
timestamp (required)
Timestamp on which to base future/past calculations
If not supplied then the current time of the LibraryThing server (UTC -5) will be used.
example using ISO8601: timestamp=2009-02-12T15:19:21+00:00
example using Unix timestamp: timestamp=1238864604
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.
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: latlon=30.6,-88.1
lat and lon (optional)
A latitude/longitude pair, as separate arguments
example: lat=30.6&lon=-88.1
venue (optional)
A LibraryThing venue ID.
By using this argument you are limiting the results to only events occuring at the requested venue.
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
By using this argument you are limiting the results to only events occuring at the requested venue.
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: venue=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.
Note: This can be a verbose address, a city, a city and state, or even just a ZIP code.
example: place=28 Atlantic Street, Portland, ME
example: place=36693
Other optional arguments
distance (optional)
The distance to search from the center of the given location.
Default: 10
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
The possible values are 0 for miles and 1 for kilometers
Default: 0
example: &measure=1
days (optional)
The limit of the number of days forward to look for events near the location.
Default: 14
Default: 14
example: &days=7
limit (optional)
Maximum number of events to return.
note: The maximum events returned is 200
Default: 50
note: The maximum events returned is 200
Default: 50
example: &limit=10
Example Request
http://www.librarything.com/services/rest/1.1/?method=librarything.local.geteventsnear&latlon=30.6,-88.1&apikey=d231aa37c9b4f5d304a60a3d0ad1dad4
Example Response
Here is an example REST response for the events near latitude 30.6 and longitude -88.1