השיטה SearchDestinations של Geocoding API כוללת עכשיו מידע מפורט על חניונים ביעדים. הנתונים האלה יכולים לעזור למשתמשים לתכנן את המסלול שלהם באמצעות:
- לדעת אילו מתקני חנייה צפויים כשתגיעו.
- הערכת הזמן שצריך להקצות למציאת חנייה.
בקשה לקבלת מידע על חניה
כדי לקבל מידע על חנייה, צריך לכלול את destinations.parkingOptions במסכת השדות של הבקשה. משתמשים בכותרת X-Goog-FieldMask כדי לציין את השדות שרוצים בתשובה.
דוגמה לבקשת cURL
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-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
האובייקט הזה מכיל פרטים על מצב החנייה ביעד.
סוגי חנייה: דגלים בוליאניים שמציינים את הזמינות של סוגי חנייה ספציפיים:
-
freeParkingLot: הערך True אם יש חנייה בחינם. -
paidParkingLot: הערך True אם יש חניון בתשלום. -
freeStreetParking: הערך True אם יש חנייה ברחוב בחינם. -
paidStreetParking: הערך True אם יש חנייה ברחוב בתשלום. -
valetParking: הערך True אם יש שירות חניית רכבים. -
freeGarageParking: הערך True אם יש חניון מקורה בחינם. -
paidGarageParking: הערך True אם יש חניון בתשלום.
-
זמינות: סוג enum שמציין את רמת הקושי הכללית במציאת חנייה:
-
AVAILABILITY_UNSPECIFIED: אין מידע על זמינות חנייה. -
PLENTY: בדרך כלל קל למצוא חניה. SOMEWHAT_DIFFICULT: קשה למצוא חניה.DIFFICULT: לעיתים קרובות קשה מאוד למצוא חניה.
-
דוגמה לקטע קוד של תגובה
{
"destinations": [
{
"primary": {
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
// ... other primary place fields
},
"parkingOptions": {
"freeParkingLot": true,
"paidParkingLot": false,
"freeStreetParking": true,
"paidStreetParking": true,
"valetParking": false,
"freeGarageParking": false,
"paidGarageParking": true,
"availability": "SOMEWHAT_DIFFICULT"
}
// ... other destination fields
}
]
}
משוב
זוהי תכונה ניסיונית של Geocoding API. נשמח לקבל משוב בכתובת geocoding-feedback-channel@google.com.