Uzyskiwanie informacji o parkingu

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Metoda SearchDestinations interfejsu Geocoding API zawiera teraz szczegółowe informacje o parkingach w miejscach docelowych. Te dane mogą pomóc użytkownikom zaplanować podróż, ponieważ:

  • informacje o tym, jakich parkingów można się spodziewać po przyjeździe;
  • oszacować, ile czasu trzeba przeznaczyć na znalezienie miejsca parkingowego;

Poproś o informacje o parkingu

Aby otrzymywać informacje o parkowaniu, musisz uwzględnić destinations.parkingOptions w masce pola żądania. Użyj nagłówka X-Goog-FieldMask, aby określić pola, które chcesz otrzymać w odpowiedzi.

Przykładowe żądanie 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

Interpretowanie odpowiedzi

Jeśli zostanie wysłane żądanie, obiekt Destination w odpowiedzi będzie zawierał pole parkingOptions.

parkingOptions

Ten obiekt zawiera szczegółowe informacje o sytuacji parkingowej w miejscu docelowym.

  • Typy parkingu: flagi logiczne wskazują dostępność określonych typów parkingu:

    • onsiteParking: wartość „true”, jeśli w miejscu docelowym jest parking.
    • freeParkingLot: wartość „True”, jeśli dostępny jest bezpłatny parking.
    • paidParkingLot: wartość „True”, jeśli dostępny jest płatny parking.
    • freeStreetParking: wartość „Prawda”, jeśli dostępny jest bezpłatny parking przy ulicy.
    • paidStreetParking: wartość „Prawda”, jeśli dostępny jest płatny parking przy ulicy.
    • valetParking: True, jeśli dostępny jest parking z obsługą.
    • freeGarageParking: wartość „Prawda”, jeśli dostępny jest bezpłatny parking w garażu.
    • paidGarageParking: True, jeśli dostępny jest płatny parking zadaszony.

  • Availability: typ wyliczeniowy wskazujący ogólny poziom trudności znalezienia parkingu:

    • AVAILABILITY_UNSPECIFIED: informacje o dostępności parkingu nie są dostępne.
    • PLENTY: zwykle łatwo znaleźć parking.
    • SOMEWHAT_DIFFICULT: znalezienie miejsca parkingowego może być trudne.
    • DIFFICULT: znalezienie parkingu jest często bardzo trudne.

  • Parking Facilities (parkingFacilities): lista obiektów ParkingFacility reprezentujących poszczególne, odrębne opcje parkowania (takie jak konkretny garaż lub parking) powiązane z miejscem docelowym:

    • place: PlaceView reprezentujący konkretny parking (w tym jego place, placeId, displayName, location, formattedAddress i displayPolygon).
    • onsite: wartość „true”, jeśli parking znajduje się na terenie głównego miejsca docelowego.
    • popular: prawda, jeśli parking jest popularnym wyborem dla osób podróżujących do głównego miejsca docelowego.
    • straightLineDistanceMeters: odległość w linii prostej w metrach od głównego miejsca docelowego do tego parkingu.

Przykładowy fragment kodu odpowiedzi

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

Prześlij opinię

To jest eksperymentalna funkcja interfejsu Geocoding API. Będziemy wdzięczni za opinie przesłane na adres geocoding-feedback-channel@google.com.