تحسين ترتيب المحطات في مسارك

بشكل تلقائي، تحسب طريقة Compute Routes في Routes API مسارًا يمرّ بعدة محطات، تُعرف باسم نقاط المرور، بالترتيب الذي تقدّمه.

يمكنك أن تطلب من Routes API تحسين المسار المقدَّم من خلال إعادة ترتيب المحطات بترتيب أكثر كفاءة. تعمل ميزة "تحسين نقاط المرور" على تحسين وقت السفر، ولكنها تأخذ في الاعتبار أيضًا عوامل أخرى، مثل المسافة وعدد المنعطفات عند تحديد المسار الأكثر فعالية.

لتحسين نقاط الطريق

1. تأكَّد من أنّ قيمة via في جميع نقاط الطريق ضمن المسار ليست true، مثل: {"address": "Clare,SA", "via": true}. لمزيد من المعلومات حول نقاط المرور، يُرجى الاطّلاع على تحديد نقاط المرور.

2. تأكَّد من أنّ السمة routing_preference ليست مضبوطة على TRAFFIC_AWARE_OPTIMAL.

3. اضبط النوع optimize_waypoint_order على true. على سبيل المثال:

   "optimizeWaypointOrder": "true",

4. حدِّد الحقل routes.optimizedIntermediateWaypointIndex في قناع الحقل:

   REST

   -H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex

   RPC

   const (fieldMask = "routes.optimizedIntermediateWaypointIndex")

فهم كيفية تحسين ترتيب نقاط الطريق

في ما يلي كيفية تحسين واجهة برمجة التطبيقات Routes API لترتيب نقاط الطريق في مسار:

1. يتم تلقائيًا فهرسة نقاط الطريق استنادًا إلى الترتيب الذي تقدّمه في الطلب، بدءًا من 0.

2. تحسِّن هذه السمة ترتيب نقاط الطريق باستخدام أرقام الفهرس التي تم تعيينها لنقاط الطريق في الطلب.

3. تعرض هذه السمة ترتيب نقاط الطريق المحسَّن في الكائن routes، في الحقل waypoint_order، ضمن routes.optimizedIntermediateWaypointIndex.

مثال

يطلب هذا الطلب تحسين مسار من "أديلايد"، جنوب أستراليا، إلى كل منطقة من مناطق صناعة النبيذ الرئيسية في جنوب أستراليا، ثم العودة إلى "أديلايد".

curl -X POST -H 'content-type: application/json' -d ' {
  "origin": {
    "address": "Adelaide,SA"
  },
  "destination": {
    "address": "Adelaide,SA"
  },
  "intermediates": [
    {"address": "Barossa+Valley,SA"},
    {"address": "Clare,SA"},
    {"address": "Coonawarra,SA"},
    {"address": "McLaren+Vale,SA"}
  ],
  "travelMode": "DRIVE",
  "optimizeWaypointOrder": "true"
  }' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes,geocodingResults.intermediates.intermediateWaypointRequestIndex' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

تفهرس واجهة Routes API نقاط المرور الوسيطة المقدَّمة في الطلب، بدءًا من 0. على سبيل المثال:

0    {"address": "Barossa+Valley,SA"},
1    {"address": "Clare,SA"},
2    {"address": "Coonawarrav,SA"},
3    {"address": "McLaren+Vale,SA"}

باستخدام أرقام الفهرس لنقاط الطريق الأربع المقدَّمة في الطلب، تعرض الخدمة بعد ذلك الترتيب المحسّن:

"optimizedIntermediateWaypointIndex": [
                3,
                2,
                0,
                1
            ]