주차 정보 확인

유럽 경제 지역 (EEA) 개발자

이제 Geocoding API의 SearchDestinations 메서드에 목적지의 자세한 주차 정보가 포함됩니다. 이 데이터는 사용자가 다음과 같은 방법으로 여정을 계획하는 데 도움이 됩니다.

  • 도착 시 어떤 주차 시설을 이용할 수 있는지 파악합니다.
  • 주차 공간을 찾는 데 할애할 시간을 가늠합니다.

주차 정보 요청

주차 정보를 수신하려면 요청의 필드 마스크에 destinations.parkingOptions를 포함해야 합니다. X-Goog-FieldMask 헤더를 사용하여 응답에 포함할 필드를 지정합니다.

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

응답 이해

요청된 경우 응답의 Destination 객체에 parkingOptions 필드가 포함됩니다.

parkingOptions

이 객체에는 목적지의 주차 상황에 관한 세부정보가 포함됩니다.

  • 주차 유형: 불리언 플래그는 특정 주차 유형의 사용 가능 여부를 나타냅니다.

    • onsiteParking: 목적지에 구내 주차장이 있는 경우 true입니다.
    • freeParkingLot: 무료 주차장을 이용할 수 있는 경우 true입니다.
    • paidParkingLot: 유료 주차장을 이용할 수 있는 경우 true입니다.
    • freeStreetParking: 무료 노상 주차가 가능한 경우 true입니다.
    • paidStreetParking: 유료 노상 주차가 가능한 경우 true입니다.
    • valetParking: 발레파킹이 가능한 경우 true입니다.
    • freeGarageParking: 무료 실내 주차장을 이용할 수 있는 경우 true입니다.
    • paidGarageParking: 유료 주차 빌딩을 이용할 수 있는 경우 true입니다.

  • Availability: 주차장을 찾는 일반적인 난이도를 나타내는 enum입니다.

    • AVAILABILITY_UNSPECIFIED: 주차 가능 여부 정보를 사용할 수 없습니다.
    • PLENTY: 일반적으로 주차 공간을 쉽게 찾을 수 있습니다.
    • SOMEWHAT_DIFFICULT: 주차장을 찾기 어려울 수 있습니다.
    • DIFFICULT: 주차장을 찾기가 매우 어려운 경우가 많습니다.

  • 주차 시설 (parkingFacilities): 목적지와 연결된 개별 주차 옵션 (예: 특정 주차 빌딩 또는 주차장)을 나타내는 ParkingFacility 객체의 목록입니다.

    • place: 특정 주차 시설 (place, placeId, displayName, location, formattedAddress, displayPolygon 포함)을 나타내는 PlaceView입니다.
    • onsite: 주차 시설이 기본 목적지 내에 있는 경우 True입니다.
    • popular: 주차 시설이 기본 목적지로 이동하는 방문자에게 인기 있는 선택지인 경우 true입니다.
    • straightLineDistanceMeters: 기본 목적지에서 이 주차 시설까지의 직선거리(미터)입니다.

응답 스니펫 예시

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

의견

이 기능은 Geocoding API의 실험용 기능입니다. geocoding-feedback-channel@google.com으로 의견을 보내주시면 감사하겠습니다.