دریافت اطلاعات پارکینگ

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

روش 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: اگر پارکینگ سرباز پولی دردسترس باشد، True (بله) است.
    • ‫freeStreetParking: اگر پارکینگ کنار خیابان رایگان دردسترس باشد، True (درست) است.
    • ‫paidStreetParking: اگر پارکینگ پولی کنار خیابان دردسترس باشد، True (درست) است.
    • ‫valetParking: اگر خدمات ماشین‌پایی دردسترس باشد، True (درست) است.
    • freeGarageParking: اگر پارکینگ سرپوشیده رایگان دردسترس باشد، True (درست) است.
    • ‫paidGarageParking: اگر پارکینگ پولی در گاراژ دردسترس باشد، True (درست) است.

  • دردسترس بودن: شمارشی که نشان‌دهنده دشواری کلی پیدا کردن پارکینگ است:

    • AVAILABILITY_UNSPECIFIED: اطلاعات دردسترس بودن پارکینگ موجود نیست.
    • PLENTY: معمولاً پیدا کردن جای پارک آسان است.
    • SOMEWHAT_DIFFICULT: پیدا کردن جای پارک می‌تواند چالش‌برانگیز باشد.
    • DIFFICULT: پیدا کردن جای پارک اغلب بسیار دشوار است.

  • تسهیلات پارکینگ (parkingFacilities): فهرستی از ParkingFacility شیء که گزینه‌های پارکینگ مجزا و متمایز (مانند پارکینگ یا گاراژ خاص) مرتبط با مقصد را نشان می‌دهد:

    • place: PlaceView که نشان‌دهنده پارکینگ خاصی است (ازجمله place، placeId، displayName، location، formattedAddress، و displayPolygon آن).
    • onsite: اگر پارکینگ در محل مقصد اصلی قرار داشته باشد، مقدار «درست» است.
    • 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 قدردانی می‌کنیم.