تحديد محطة على طول المسار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
لتحديد محطة على طول مسار، مثلاً لنقل الركاب أو إنزالهم، يمكنك تحديد نقطة علامية كنقطة علامية للتوقف. لإجراء ذلك، استخدِم السمة vehicleStopover
لنقطة الطريق،
Waypoint (بروتوكول REST) أو
Waypoint (بروتوكول gRPC).
يضمن هذا الإعداد ألا يبدأ المسار المحسوب أو ينتهي على طريق
غير مناسب لنقل الركاب، مثل طريق سريع أو نفق.
فكِّر في الحالة التي تعبر فيها طريق سطحية فوق طريق داخل نفق.
إذا أردت تحديد نقطة طريق تقع عند تقاطع الطريقَين (كما هو موضّح
على الخريطة)، سيبدأ المسار الناتج أو ينتهي إما على الطريق
السطحي أو النفق. تؤدي هذه النتيجة إلى حدوث مشكلة لأنّه لا يمكنك التوقف في
الممرات النفقية لنقل الركاب أو تسليمهم.
إذا كنت تريد استخدام نقطة الطريق لعملية استلام أو تسليم، يمكنك ضبط الحقل
vehicleStopover على true لضمان أن يبدأ المسار الناتج أو
ينتهي على طريق تسمح بعمليات الاستلام والتسليم.
يوضّح المثال التالي كيفية ضبط السمة
vehicleStopover:
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"vehicleStopover": true
},
...
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUse the \u003ccode\u003evehicleStopover\u003c/code\u003e property to designate a waypoint as a stopover for pickups or drop-offs, ensuring the route avoids unsuitable roads like highways or tunnels.\u003c/p\u003e\n"],["\u003cp\u003eRequests utilizing the \u003ccode\u003evehicleStopover\u003c/code\u003e property incur higher billing rates compared to standard route requests.\u003c/p\u003e\n"],["\u003cp\u003eSetting \u003ccode\u003evehicleStopover\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e guarantees the route starts or ends on a road suitable for pickups and drop-offs, avoiding issues with waypoints located near tunnels or highways.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003evehicleStopover\u003c/code\u003e property is crucial for optimizing routes for vehicles that require specific pickup and drop-off locations.\u003c/p\u003e\n"]]],["To designate a waypoint for pickup or drop-off, set the `vehicleStopover` property to `true` within the Waypoint object. This ensures the route begins or ends on a suitable road, avoiding locations like highways or tunnels. Setting `vehicleStopover` prevents routes from starting/ending on unsuitable roads. The `vehicleStopover` property is set within the Waypoint's JSON structure. Using `vehicleStopover` incurs a higher billing rate.\n"],null,["# Set a stop along a route\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nTo set a stop along a route, for example, for a pickup or dropoff, you designate\na waypoint as a stopover waypoint. To do this, use the `vehicleStopover`\nproperty of a waypoint,\n[Waypoint](/maps/documentation/routes/reference/rest/v2/Waypoint) (REST) or\n[Waypoint](/maps/documentation/routes/reference/rpc/google.maps.routing.v2#waypoint) (gRPC).\nThis setting ensures that the calculated route doesn't begin or end on a road\nthat is unsuitable for pickup and drop-off, such as a highway or tunnel.\n| **Caution:** Requests using `vehicleStopover` are billed at a higher rate. [Learn more about billing](/maps/documentation/routes/usage-and-billing) for Routes API.\n\nConsider the situation where a surface road crosses over a road inside a tunnel.\nIf you were to specify a waypoint located where the two roads intersect (as seen\non a map), then the resulting route would begin or end on either the surface\nroad or the tunnel. This result presents a problem because you can't stop in\ntunnels to make pickups or drop-offs.\n\nIf you want to use the waypoint for a pickup or drop-off, then you set the\n`vehicleStopover` field to `true` to ensure that the resulting route begins or\nends on a road that allows pickups and drop-offs.\n\nThe following example demonstrates how to set the\n[`vehicleStopover`](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#Waypoint.FIELDS.vehicle_stopover)\nproperty: \n\n```text\n{\n \"origin\":{\n \"location\":{\n \"latLng\":{\n \"latitude\": 37.419734,\n \"longitude\": -122.0827784\n }\n },\n \"vehicleStopover\": true\n },\n ...\n}\n```"]]
