קבלת מידע על חנייה

מפתחים באזור הכלכלי האירופי (EEA)

ה-method‏ SearchDestinations של Geocoding API כוללת עכשיו מידע מפורט על חנייה ביעדים. הנתונים האלה יכולים לעזור למשתמשים לתכנן את הנסיעה שלהם:

  • להבין אילו מתקני חנייה צפויים להיות זמינים כשהם מגיעים.
  • להעריך כמה זמן צריך להקדיש לחיפוש חנייה.

בקשת מידע על חניה

כדי לקבל מידע על חנייה, צריך לכלול את 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: בדרך כלל קשה מאוד למצוא חניה.

  • ‫Parking Facilities (parkingFacilities): רשימה של אובייקטים מסוג ParkingFacility שמייצגים אפשרויות חנייה נפרדות (כמו חניון או מגרש חנייה ספציפי) שמשויכות ליעד:

    • ‫place: אובייקט PlaceView שמייצג את מתקן החנייה הספציפי (כולל place,‏ placeId,‏ displayName,‏ location,‏ formattedAddress ו-displayPolygon).
    • ‫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.