Find Parking Zones
GET/zones
Finds nearby "on-street" parking zones, sorted by distance, that are available at the specified location and time.
NOTE: Search results will **ONLY be returned if the `start` time is INSIDE their operating schedule**, in other words, a search performed for Sunday afternoon will likely yield ZERO results, even if the user is standing inside a regulated parking zone.
NOTE2: Due to GPS error margins (typically 5 metres for mobile devices, more in built-up locations) there might be multiple parking zones in the results. Please ask the user to confirm which one if this is the case.
Request
Query Parameters
Default value: 40.4674229
Geo Latitude to check if there is on-street parking.
Default value: -3.6823719
Geo Longitude to check if there is on-street parking.
Default value: now
Optional ISO datetime to check for parking zone availability (defaults to now
, past dates will be treated as now
).
Default value: 5
Optional GPS precision in metres (defaults to 5
, max 100
)
Header Parameters
HTTP authentication header obtained from POST /authenticate
or POST /user
that identifies the user making this call.
- application/json
Body
Journey details
- Array [
- ]
journey_coordinates object[]
Latitude
Longitude
Current time
Responses
- 200
- 400
- 495
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
A unique identifier for this "on street" regulated parking zone
The type of the regulated parking zone
The name of the regulated parking zone
The name/identifier of the parking city
The area where this regulated zone is located.
The region where this regulated zone is located.
The 2-letter country code where zone is located
The time when user can start parking in this zone
The maximum parking duration allowed in this zone (in minutes)
The distance from search coordinates in metres (0
means that coordinates are inside the zone)
The identifier of the area. Only in Barcelona
[
{
"lmpzid": "provider-C01B031T0",
"name": "AZUL",
"subname": "Barrio 56",
"city": "MADRID",
"area": "Madrid",
"region": "Madrid",
"country": "ES",
"start": "2020-02-16T11:30:00.000+01:00",
"max_duration": 120,
"distance": 0,
"sectionId": 10
}
]
Bad request (ie. Missing or invalid lat/long coordinates)
Error when service is out of hours (return start service date)
Internal server Error (ie. Database down)