Obtenir des informations sur le stationnement

Développeurs de l'Espace économique européen (EEE)

La méthode SearchDestinations de l'API Geocoding inclut désormais des informations détaillées sur le stationnement pour les destinations. Ces données peuvent aider les utilisateurs à planifier leur trajet :

  • Savoir à quels parkings s'attendre à l'arrivée
  • Estimer le temps nécessaire pour trouver une place de parking

Demander des informations sur le stationnement

Pour recevoir des informations sur le stationnement, vous devez inclure destinations.parkingOptions dans le masque de champ de votre requête. Utilisez l'en-tête X-Goog-FieldMask pour spécifier les champs que vous souhaitez inclure dans la réponse.

Exemple de requête cURL

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

Comprendre la réponse

Si demandé, l'objet Destination de la réponse contiendra un champ parkingOptions.

parkingOptions

Cet objet contient des informations sur les possibilités de stationnement à destination.

  • Types de parkings : des indicateurs booléens indiquent la disponibilité de types de parkings spécifiques :

    • onsiteParking : "True" si un parking est disponible sur place à la destination.
    • freeParkingLot : "True" si un parking gratuit est disponible.
    • paidParkingLot : "True" si un parking payant est disponible.
    • freeStreetParking : "True" si un stationnement sur rue sans frais est disponible.
    • paidStreetParking : "True" si un stationnement payant sur rue est disponible.
    • valetParking : "True" si un service de voiturier est disponible.
    • freeGarageParking : "True" si un parking couvert sans frais est disponible.
    • paidGarageParking : "True" si un parking couvert payant est disponible.

  • Disponibilité : énumération indiquant la difficulté générale de trouver une place de stationnement :

    • AVAILABILITY_UNSPECIFIED : les informations sur la disponibilité du parking ne sont pas disponibles.
    • PLENTY : il est généralement facile de trouver une place de parking.
    • SOMEWHAT_DIFFICULT : Trouver une place de parking peut être difficile.
    • DIFFICULT : il est souvent très difficile de trouver une place de stationnement.

  • Parking Facilities (parkingFacilities) : liste d'objets ParkingFacility représentant des options de stationnement individuelles et distinctes (comme un parking couvert ou un parking spécifique) associées à la destination :

    • place : PlaceView représentant le parking spécifique (y compris ses place, placeId, displayName, location, formattedAddress et displayPolygon).
    • onsite : "True" si le parking se trouve sur le site de la destination principale.
    • popular : "True" si le parking est un choix populaire pour les visiteurs se rendant à la destination principale.
    • straightLineDistanceMeters : distance en ligne droite, en mètres, entre la destination principale et ce parking.

Exemple d'extrait de réponse

{
  "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
    }
  ]
}

Commentaires

Il s'agit d'une fonctionnalité expérimentale de l'API Geocoding. N'hésitez pas à nous faire part de vos commentaires à l'adresse geocoding-feedback-channel@google.com.