The SearchDestinations
method of the Geocoding API now includes detailed parking information for
destinations. This data can help users plan their journey by:
- Understanding what parking facilities to expect upon arrival.
- Gauging how much time to allocate for finding parking.
Request parking information
To receive parking information, you must include
destinations.parkingOptions
in your request's field mask. Use the X-Goog-FieldMask header to specify the
fields you want in the response.
Example cURL request
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.primary.place,destinations.parkingOptions" \
https://geocode.googleapis.com/v4alpha/geocode/destinations
Understand the response
If requested, the Destination object in the response will contain a
parkingOptions field.
parkingOptions
This object contains details about the parking situation at the destination.
Parking Types: Boolean flags indicate the availability of specific parking types:
freeParkingLot: True if free lot parking is available.paidParkingLot: True if paid lot parking is available.freeStreetParking: True if free street parking is available.paidStreetParking: True if paid street parking is available.valetParking: True if valet parking is available.freeGarageParking: True if free garage parking is available.paidGarageParking: True if paid garage parking is available.
Availability: An enum indicating the general difficulty of finding parking:
AVAILABILITY_UNSPECIFIED: Parking availability information is not available.PLENTY: Typically easy to find parking.SOMEWHAT_DIFFICULT: Finding parking can be challenging.DIFFICULT: Finding parking is often very difficult.
Example response snippet
{
"destinations": [
{
"primary": {
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
// ... other primary place fields
},
"parkingOptions": {
"freeParkingLot": true,
"paidParkingLot": false,
"freeStreetParking": true,
"paidStreetParking": true,
"valetParking": false,
"freeGarageParking": false,
"paidGarageParking": true,
"availability": "SOMEWHAT_DIFFICULT"
}
// ... other destination fields
}
]
}
Feedback
This is an experimental feature of the Geocoding API. We would appreciate feedback at geocoding-feedback-channel@google.com.