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

بشكل تلقائي، تحتسب طريقة 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

   الإيرادات لكل نقرة

   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
            ]