تحديد محطة على طول المسار

يمكنك ضبط محطة على طول مسار، مثل محطة لاستلام الركاب أو إنزالهم، بإحدى الطريقتَين التاليتَين:

• إضافة نقطة طريق وسيطة: هذا هو الخيار التلقائي. أضِف نقطة طريق وسيطة بين نقطة البداية والوجهة في مصفوفة intermediates. يربط محرّك التوجيه نقطة الطريق بأقرب طريق يمكن سلوكه ويقسّم المسار إلى أجزاء RouteLeg متصلة بهذه المحطة.
• تحديد `vehicleStopover`: إذا كنت تريد أن يُجري محرّك التوجيه تحليلًا إضافيًا لتجنُّب أجزاء الطرق غير المناسبة للتوقف، مثل الطرق السريعة أو الأنفاق أو الجسور العلوية، اضبط vehicleStopover: true على نقطة الطريق.

إضافة نقطة طريق وسيطة

لضبط محطة على طول مسار، أضِف نقطة طريق وسيطة إلى مصفوفة intermediates في طلبك.

تؤدي إضافة نقطة طريق وسيطة إلى ما يلي:

• ينقسم المسار إلى أجزاء RouteLeg: يربط كل جزء محطة بالمحطة التالية.
• يتم ربط الإحداثيات بطريق: يربط محرّك التوجيه إحداثيات خطوط الطول والعرض، التي قد تكون على سطح مبنى أو في ساحة، بأقرب جزء من طريق يمكن سلوكه.

بالنسبة إلى العديد من الطرق البرية، يؤدي الربط بأقرب طريق إلى توفير موقع محطة عملي. ومع ذلك، لا يحدّد الربط ما إذا كان جزء الطريق هذا مناسبًا للتوقف، مثلما يحدث عندما يكون أقرب طريق هو طريقًا سريعًا أو نفقًا.

مثال: إضافة نقطة طريق وسيطة

يوضّح المثال التالي كيفية ضبط محطة على طول مسار عن طريق إضافة نقطة طريق وسيطة في طلب computeRoutes من نوع POST:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

لمزيد من المعلومات عن نقاط الطريق الوسيطة وأجزاء المسار، يُرجى الاطّلاع على مقالة ضبط نقاط الطريق الوسيطة.

تحديد `vehicleStopover` لتقييم مدى ملاءمة الاستلام والإنزال

في حين يتم ربط نقطة الطريق الوسيطة العادية بأقرب طريق، لا يكون هذا الطريق مناسبًا دائمًا لتوقف المركبة. إذا كنت تريد أن يُجري محرّك التوجيه تحليلًا إضافيًا لتقييم مدى ملاءمة الطريق لاستلام الركاب أو إنزالهم، اضبط vehicleStopover: true على نقطة الطريق.

عند ضبط vehicleStopover: true، يقيّم محرّك التوجيه أجزاء الطرق المحتمَلة ويحاول تجنُّب الطرق غير المناسبة للتوقف، مثل الطرق السريعة والأنفاق والجسور العلوية.

على سبيل المثال، لنفترض أنّ هناك موقعًا يمر فيه طريق بري فوق طريق سريع داخل نفق: * نقطة طريق وسيطة عادية: يتم ربطها بالطريق السريع أو النفق الموجود أسفله إذا كان أقرب هندسيًا إلى إحداثياتك. * توقف المركبة: يُجري محرّك التوجيه تحليلًا إضافيًا لتجاوز الطريق السريع والنفق، وربط المحطة بطريق بري مناسب للتوقف.

مثال: تحديد `vehicleStopover` على نقطة طريق

يوضّح المثال التالي كيفية ضبط vehicleStopover: true على نقطة طريق وسيطة في طلب POST كامل:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

لمزيد من المعلومات عن أنواع نقاط الطريق وخياراتها، يُرجى الاطّلاع على مقالة أنواع نقاط الطريق و خياراتها.