Parkplatzinformationen abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Die Methode SearchDestinations der Geocoding API enthält jetzt detaillierte Parkinformationen für Ziele. Anhand dieser Daten können Nutzer ihre Fahrt besser planen:

  • Informationen zu den Parkmöglichkeiten bei der Ankunft
  • Einschätzen, wie viel Zeit für die Parkplatzsuche eingeplant werden muss.

Parkplatzinformationen anfordern

Wenn Sie Parkinformationen erhalten möchten, müssen Sie destinations.parkingOptions in die Feldmaske Ihrer Anfrage einfügen. Verwenden Sie den Header X-Goog-FieldMask, um die Felder anzugeben, die in der Antwort enthalten sein sollen.

Beispiel für eine cURL-Anfrage

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

Antwort verstehen

Falls angefordert, enthält das Destination-Objekt in der Antwort ein parkingOptions-Feld.

parkingOptions

Dieses Objekt enthält Details zur Parksituation am Zielort.

  • Parkmöglichkeiten:Boolesche Flags geben die Verfügbarkeit bestimmter Parkmöglichkeiten an:

    • onsiteParking: „true“, wenn am Ziel Parkplätze vorhanden sind.
    • freeParkingLot: „True“, wenn kostenlose Parkplätze vorhanden sind.
    • paidParkingLot: „Wahr“, wenn ein gebührenpflichtiger Parkplatz vorhanden ist.
    • freeStreetParking: „True“, wenn kostenlose Parkplätze an der Straße verfügbar sind.
    • paidStreetParking: „True“, wenn gebührenpflichtige Parkplätze an der Straße verfügbar sind.
    • valetParking: „True“, wenn ein Einparkservice verfügbar ist.
    • freeGarageParking: „True“, wenn kostenlose Parkplätze in einer Garage verfügbar sind.
    • paidGarageParking: „True“, wenn gebührenpflichtige Parkplätze in einer Garage verfügbar sind.
  • Availability:Ein Enum, das die allgemeine Schwierigkeit angibt, einen Parkplatz zu finden:

    • AVAILABILITY_UNSPECIFIED: Informationen zur Parkplatzverfügbarkeit sind nicht verfügbar.
    • PLENTY: Normalerweise ist es einfach, einen Parkplatz zu finden.
    • SOMEWHAT_DIFFICULT: Die Parkplatzsuche kann schwierig sein.
    • DIFFICULT: Es ist oft sehr schwierig, einen Parkplatz zu finden.
  • Parkmöglichkeiten (parkingFacilities): Eine Liste von ParkingFacility-Objekten, die einzelne, separate Parkmöglichkeiten (z. B. ein bestimmtes Parkhaus oder einen bestimmten Parkplatz) am Zielort darstellen:

    • place: Ein PlaceView, das die spezifische Parkeinrichtung darstellt (einschließlich place, placeId, displayName, location, formattedAddress und displayPolygon).
    • onsite: „True“, wenn sich die Parkmöglichkeit auf dem Gelände des Hauptziels befindet.
    • popular: „True“, wenn die Parkmöglichkeit bei Besuchern, die zum Hauptziel reisen, beliebt ist.
    • straightLineDistanceMeters: Die Luftlinie in Metern vom Hauptziel zu dieser Parkeinrichtung.

Beispiel für ein Antwort-Snippet

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

Dies ist eine experimentelle Funktion der Geocoding API. Wir freuen uns über Feedback an geocoding-feedback-channel@google.com.