الحصول على معلومات عن مواقف السيارات

المطوّرون في المنطقة الاقتصادية الأوروبية

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

  • ‫Availability: تعداد يشير إلى الصعوبة العامة في العثور على موقف سيارات:

    • ‫AVAILABILITY_UNSPECIFIED: لا تتوفّر معلومات حول توفُّر مواقف للسيارات.
    • ‫PLENTY: من السهل عادةً العثور على موقف للسيارات.
    • ‫SOMEWHAT_DIFFICULT: قد يكون من الصعب العثور على موقف سيارات.
    • ‫DIFFICULT: غالبًا ما يكون العثور على موقف سيارات صعبًا جدًا.

  • مرافق مواقف السيارات (parkingFacilities): قائمة بعناصر ParkingFacility تمثّل خيارات مواقف سيارات فردية ومنفصلة (مثل مرآب سيارات أو موقف سيارات معيّن) مرتبطة بالوجهة:

    • ‫place: تمثّل السمة PlaceView موقف السيارات المحدّد (بما في ذلك place وplaceId وdisplayName وlocation وformattedAddress وdisplayPolygon).
    • ‫onsite: تكون القيمة "صحيح" إذا كان موقف السيارات يقع في الموقع الجغرافي للوجهة الأساسية.
    • ‫popular: تكون القيمة "صحيح" إذا كان موقف السيارات خيارًا رائجًا للزوار الذين يسافرون إلى الوجهة الأساسية.
    • ‫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.