ParkWhiz API: Search

Search for parking at a specific location and time. Note only parking locations that accept reservations will be returned.

Request

http://api.parkwhiz.com/search/ GET

Parameters

Field	Type	Desc
key	string	ParkWhiz public API key
destination	string	Street address, city and state
lat	float	Latitude
lng	float	Longitude
start	integer	Start time of the desired parking, expressed as a Unix Timestamp
end	integer	End time of the desired parking, expressed as a Unix Timestamp
sort	string	One of: rating, distance, price. Defaults to rating.
price	float	Only return locations with prices lower than the passed value
shuttle	1 or 0	Only return locations with shuttle service
eticket	1 or 0	Only return locations that accept Mobile Passes
perk	1 or 0	Only return locations that offer ParkWhiz Perks
valet	1 or 0	Only return locations that offer valet service
indoor	1 or 0	Only return indoor/covered locations
handicap	1 or 0	Only return handicap accessible locations
restroom	1 or 0	Only return locations that provide a restroom to customers
security	1 or 0	Only return locations with on-site security
tailgate	1 or 0	Only return locations that allow tailgating
rv	1 or 0	Only return locations that allow RV parking
unobstructed	1 or 0	Only return locations with unobstructed parking spots (vehicle won't be blocked in)
attended	1 or 0	Only return locations with an on-site parking attendant

A latitude/longitude pair can be used in place of a destination; only one or the other is required. Pricing information will only be returned if a start and end parameter is provided.

Example call

http://api.parkwhiz.com/search/?destination=312+N+wacker+Dr,+Chicago&start=1369323108&end=1369333908&key=62d882d8cfe5680004fa849286b6ce20

Returns

Field	Type	Desc
parkwhiz_url	string	URL of this query in human-readable format on ParkWhiz.com
lat	float	Latitude of the search location
lng	float	Longitude of the search location
min_price	float	Minimum price of the returned search results. This field is null of there are no search results.
max_price	float	Maximum price of the returned search results. This field is null of there are no search results.
min_distance	integer	Minimum distance in feet of the returned search results. This field is null of there are no search results.
max_distance	integer	Maximum distance in feet of the returned search results. This field is null of there are no search results.
amenities	object	A hash of how many of the returned locations offer certain amenities
parking_listings	array	A list of parking listings that matched the search parameters. The default sorting orders the results in ascending order by distance. Each entry has the following format:

parking_listings Object Parameters

Field	Type	Desc
location_name	string	The display name of the parking location
location_id	integer	ID number of the parking location
listing_id	integer	ID number of the parking listing
parkwhiz_url	string	URL of this location on ParkWhiz.com
api_url	string	URL to retreive more info about this location via the JSON API
address	string	Street address of the parking location
city	string	City of the parking location
state	string	US State or Canadian province of the parking location
zip	integer	Zip code of the parking location
lat	float	Latitude of the parking location
lng	float	Longitude of the parking location
eticket	integer	Boolean (1 or 0) whether the location accepts mobile parking passes
distance	integer	Distance in feet from the search query destination
recommendations	integer	Number of ParkWhiz customers who gave this location positive feedback
available_spots	integer	Number of parking spaces available for reservation
price	float	Price to reserve a parking space for this location and time

Example response

{
	"parkwhiz_url": "http:\/\/api.parkwhiz.com\/search\/?destination=312+N+wacker+Dr%2C+Chicago%2C+IL&start=1289840400&end=1289853000",
	"lat": 41.8857256,
	"lng": -87.6369590,
	"min_price": 27.50,
	"min_distance": 111,
	"parking_listings": [
		{
			"location_name": "Central Parking",
			"listing_id": 3609,
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/p\/chicago-parking\/191-n-wacker-dr\/?start=1289840400&end=1289853000",
			"api_url": "http:\/\/api.parkwhiz.com\/p\/chicago-parking\/191-n-wacker-dr\/?start=1289840400&end=1289853000",
			"address": "191 N Wacker Dr",
			"city": "Chicago",
			"state": "IL",
			"zip": "60606",
			"lat": 41.885507,
			"lng": -87.636674,
			"eticket": 1,
			"distance": 111,
			"reservation": 0,
			"recommendations": 0,
			"available_spots": 0,
			"price": 27.50
		},
		{
			"location_name": "Franklin Self Park Garage",
			"listing_id": 6046,
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/p\/chicago-parking\/180-n-franklin-st\/?start=1289840400&end=1289853000",
			"api_url": "http:\/\/api.parkwhiz.com\/p\/chicago-parking\/180-n-franklin-st\/?start=1289840400&end=1289853000",
			"address": "180 N Franklin St",
			"city": "Chicago",
			"state": "IL",
			"zip": "60606",
			"lat": 41.885305,
			"lng": -87.635583,
			"eticket": 0
			"distance": 0,
			"reservation": 1,
			"recommendations": 0,
			"available_spots": 10,
			"price": 28.60
		},
		...
	]
}