يتضمّن الآن 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: تكون القيمة "صحيح" إذا كان موقف السيارات المجاني متاحًا.paidParkingLot: تكون القيمة "صحيح" إذا كان موقف السيارات المدفوع متاحًا.freeStreetParking: تكون القيمة "صحيح" إذا كان موقف سيارات مجاني في الشارع متاحًا.paidStreetParking: تكون القيمة "صحيح" إذا كان موقف سيارات مدفوع في الشارع متاحًا.valetParking: تكون القيمة "صحيح" إذا كانت خدمة ركن السيارات متاحًا.freeGarageParking: تكون القيمة "صحيح" إذا كان ركن السيارات المجاني في المرآب متاحًا.paidGarageParking: تكون القيمة "صحيح" إذا كان ركن السيارات المدفوع في المرآب متاحًا.
مدى التوفّر: هي قيمة تعداد تشير إلى الصعوبة العامة في العثور على موقف سيارات:
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.