Xem thông tin về nơi đỗ xe

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Phương thức SearchDestinations của Geocoding API hiện bao gồm thông tin chi tiết về bãi đỗ xe cho các điểm đến. Dữ liệu này có thể giúp người dùng lên kế hoạch cho hành trình của họ bằng cách:

  • Biết được nơi đỗ xe khi đến nơi.
  • Ước tính thời gian cần dành ra để tìm chỗ đỗ xe.

Yêu cầu thông tin về bãi đỗ xe

Để nhận thông tin về bãi đỗ xe, bạn phải thêm destinations.parkingOptions vào mặt nạ trường của yêu cầu. Sử dụng tiêu đề X-Goog-FieldMask để chỉ định các trường bạn muốn trong phản hồi.

Ví dụ về yêu cầu 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

Hiểu rõ câu trả lời

Nếu được yêu cầu, đối tượng Destination trong phản hồi sẽ chứa trường parkingOptions.

parkingOptions

Đối tượng này chứa thông tin chi tiết về tình hình đỗ xe tại điểm đến.

  • Loại bãi đỗ xe: Cờ boolean cho biết tình trạng còn trống của các loại bãi đỗ xe cụ thể:

    • onsiteParking: True nếu có bãi đỗ xe tại điểm đến.
    • freeParkingLot: True nếu có bãi đỗ xe miễn phí.
    • paidParkingLot: True nếu có bãi đỗ xe có tính phí.
    • freeStreetParking: True nếu có chỗ đỗ xe trên đường miễn phí.
    • paidStreetParking: True nếu có chỗ đỗ xe trên đường có tính phí.
    • valetParking: True nếu có dịch vụ đỗ xe.
    • freeGarageParking: True nếu có gara đỗ xe miễn phí.
    • paidGarageParking: True nếu có nhà để xe có tính phí.

  • Availability: Một enum cho biết mức độ khó khăn chung khi tìm chỗ đỗ xe:

    • AVAILABILITY_UNSPECIFIED: Không có thông tin về tình trạng chỗ đỗ xe.
    • PLENTY: Thường dễ tìm chỗ đỗ xe.
    • SOMEWHAT_DIFFICULT: Việc tìm chỗ đỗ xe có thể gặp khó khăn.
    • DIFFICULT: Thường rất khó tìm chỗ đỗ xe.

  • Parking Facilities (parkingFacilities): Danh sách các đối tượng ParkingFacility đại diện cho các lựa chọn đỗ xe riêng lẻ, riêng biệt (chẳng hạn như một gara đỗ xe hoặc bãi đỗ xe cụ thể) liên kết với điểm đến:

    • place: Một PlaceView đại diện cho bãi đỗ xe cụ thể (bao gồm place, placeId, displayName, location, formattedAddress và displayPolygon).
    • onsite: Đúng nếu bãi đỗ xe nằm trong khuôn viên của điểm đến chính.
    • popular: Đúng nếu bãi đỗ xe là lựa chọn phổ biến cho khách du lịch đến điểm đến chính.
    • straightLineDistanceMeters: Khoảng cách đường thẳng tính bằng mét từ điểm đến chính đến bãi đỗ xe này.

Đoạn mã phản hồi mẫu

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

Phản hồi

Đây là một tính năng thử nghiệm của Geocoding API. Chúng tôi rất mong nhận được ý kiến phản hồi của bạn tại geocoding-feedback-channel@google.com.