می‌توانید درطول مسیر توقفی، مثلاً برای سوار یا پیاده کردن، به یکی از دو روش زیر تنظیم کنید:
- افزودن ایستگاه بین راهی: این گزینه پیش‌فرض است. در آرایه
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'
برای اطلاعات بیشتر درباره انواع و گزینه‌های ایستگاه بین راهی، به انواع و گزینه‌های ایستگاه بین راهی مراجعه کنید.