<br />

> [!WARNING]
> This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google
> Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage descriptions](https://developers.google.com/maps/launch-stages.md.txt).

<br />

**European Economic Area (EEA) developers**

> [!NOTE]
> If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt).

The [`SearchDestinations`](https://developers.google.com/maps/documentation/geocoding/search-for-destinations.md.txt#search_destinations_response)
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.

> [!IMPORTANT]
> **Important:** This feature is available in the `v4alpha` channel.

## Request parking information

To receive parking information, you must include
[`destinations.parkingOptions`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#destination.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

```bash
curl -X POST -d '{
  "place": "places/ChIJcWnnWiz0wokRCB6aVdnDQEk"
}' \
-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:

  - `onsiteParking`: True if onsite parking exists at the destination.
  - `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.
- **Parking Facilities (`parkingFacilities`):** A list of
  [`ParkingFacility`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#Destination.ParkingOptions.ParkingFacility)
  objects representing individual, discrete parking options (such as a
  specific parking garage or lot) associated with the destination:

  - `place`: A [`PlaceView`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#PlaceView) representing the specific parking facility (including its `place`, `placeId`, `displayName`, `location`, `formattedAddress`, and `displayPolygon`).
  - `onsite`: True if the parking facility is located on-site at the primary destination.
  - `popular`: True if the parking facility is a popular choice for visitors traveling to the primary destination.
  - `straightLineDistanceMeters`: The straight-line distance in meters from the primary destination to this parking facility.

### Example response snippet

```json
{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJcWnnWiz0wokRCB6aVdnDQEk",
        "displayName": {
          "text": "Yankee Stadium",
          "languageCode": "en"
        }
        // ... other primary place fields
      },
      "parkingOptions": {
        "paidParkingLot": true,
        "freeStreetParking": true,
        "paidStreetParking": true,
        "paidGarageParking": true,
        "onsiteParking": true,
        "parkingFacilities": [
          {
            "place": {
              "place": "places/ChIJ8TdM8y70wokRToHbbtCEthQ",
              "placeId": "ChIJ8TdM8y70wokRToHbbtCEthQ",
              "displayName": {
                "text": "164th St Parking Garage",
                "languageCode": "en"
              },
              "primaryType": "parking_garage",
              "formattedAddress": "164th St Parking Garage, 65 W 164th St, Bronx, NY 10452, USA",
              "structureType": "POINT",
              "location": {
                "latitude": 40.830543999999996,
                "longitude": -73.924656
              }
              // ... other place fields
            },
            "onsite": true,
            "popular": false
          },
          {
            "place": {
              "place": "places/ChIJ-zvoYG71wokRElYeJWoI9GY",
              "placeId": "ChIJ-zvoYG71wokRElYeJWoI9GY",
              "displayName": {
                "text": "River Ave. Parking Garage",
                "languageCode": "en"
              },
              "primaryType": "parking_garage",
              "formattedAddress": "River Ave. Parking Garage, 999-943 River Ave, Bronx, NY 10452, USA",
              "structureType": "POINT",
              "location": {
                "latitude": 40.8298561,
                "longitude": -73.9245919
              }
              // ... other place fields
            },
            "onsite": false,
            "popular": false,
            "straightLineDistanceMeters": 12.754842758178711
          }
          // ... other parking facilities
        ]
      }
      // ... other destination fields
    }
  ]
}
```

## Feedback

This is an experimental feature of the Geocoding API. We would appreciate
feedback at
[geocoding-feedback-channel@google.com](mailto:geocoding-feedback-channel@google.com).