دریافت مسیرهای جایگزین

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

به‌طور پیش‌فرض، Routes API مسیر پیش‌فرض را برمی‌گرداند که معمولاً سریع‌ترین مسیر از مبدأ به مقصد است. وقتی درخواست مسیرهای جایگزین می‌کنید، API حداکثر سه مسیر را به‌همراه مسیر پیش‌فرض برمی‌گرداند. سپس مشتریانتان می‌توانند مسیری را انتخاب کنند که بیشترین تناسب را با نیازهایشان دارد.

ملاحظات هنگام درخواست مسیرهای جایگزین

برای درخواست مسیرهای جایگزین، ملاحظات زیر را درنظر داشته باشید:

  • پاسخ حداکثر حاوی سه مسیر جایگزین است. بااین‌حال، گاهی اوقات هیچ مسیر جایگزینی دردسترس نیست، بنابراین پاسخ فقط حاوی مسیر پیش‌فرض است.

  • به‌دلیل پردازش اضافی موردنیاز برای محاسبه مسیرهای جایگزین، درخواست مسیرهای جایگزین ممکن است زمان پاسخ API را افزایش دهد.

نمونه درخواست مسیرهای جایگزین

برای درخواست مسیرهای جایگزین، computeAlternativeRoutes را روی true تنظیم کنید. مثال زیر نشان می‌دهد که چگونه می‌توان مسیرهای جایگزین را در درخواست روش computeRoutes (REST) درخواست کرد.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

در این مثال، ماسک فیلدی را مشخص می‌کنید تا پاسخ فقط حاوی ویژگی‌های duration، distanceMeters,، و routeLabels برای هر مسیر باشد. سپس مشتری شما می‌تواند از آن اطلاعات برای انتخاب مسیر استفاده کند. برای اطلاعات بیشتر، به انتخاب اطلاعات برای برگرداندن مراجعه کنید.

نمونه پاسخ مسیرهای جایگزین

در پاسخ، از ویژگی آرایه routeLabels برای شناسایی مسیر دسترسی استفاده کنید:

  • برای مسیر پیش‌فرض، ویژگی routeLabels حاوی DEFAULT_ROUTE است.

  • برای هر مسیر جایگزین، ویژگی routeLabels حاوی DEFAULT_ROUTE_ALTERNATE است.

در این مثال، پاسخ حاوی مسیر پیش‌فرض و دو مسیر جایگزین است. توجه کنید که مقادیر ویژگی‌های duration و distanceMeters برای هر مسیر متفاوت است:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

گنجاندن چندخطی‌ها در پاسخ

برای اینکه کاربر راحت‌تر بتواند مسیر را انتخاب کند، چندخطی هر مسیر را به پاسخ اضافه کنید. سپس می‌توانید هر چندخطی را روی نقشه نمایش دهید.

برای افزودن چندخطی، routes.polyline را در ماسک فیلد اضافه کنید:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

سپس پاسخ حاوی چندخطی برای هر مسیر است:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}