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:
Required parameters are bold.
- 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
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=1289840400&end=1289853000&key=62d882d8cfe5680004fa849286b6ce20
Returns:
- parkwhiz_url
- URL of this query in human-readable format on ParkWhiz.com
- lat
- Latitude of the search location
- lng
- Longitude of the search location
- min_price
- Minimum price of the returned search results. This field is null of there are no search results.
- min_distance
- Minimum distance in feet of the returned search results. This field is null of there are no search results.
- parking_listings
- 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:
- location_name
- The display name of the parking location
- location_id
- ID number of the parking location
- listing_id
- ID number of the parking listing
- parkwhiz_url
- URL of this location on ParkWhiz.com
- api_url
- URL to retreive more info about this location via the JSON API
- address
- Street address of the parking location
- city
- City of the parking location
- state
- US state or Canadian province of the parking location
- zip
- Zip code of the parking location
- lat
- Latitude of the parking location
- lng
- Longitude of the parking location
- eticket
- Boolean (1 or 0) whether the location accepts mobile parking passes
- distance
- Distance in feet from the search query destination
- recommendations
- Number of ParkWhiz customers who gave this location positive feedback
- available_spots
- Number of parking spaces available for reservation
- price
- 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",
"location_id":"188",
"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",
"location_id":"189","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":"404",
"reservation":"1",
"recommendations":"0",
"available_spots":10,
"price":"28.60"
},
...
]
}
