نقاط مسیر میانی، مکانهایی هستند که بین مبدا و مقصد مشخص شدهاند و شما میخواهید مسیر از آنها عبور کند.
شما میتوانید تا ۲۵ نقطهی میانی را در یک درخواست واحد با استفاده از ویژگی آرایهی intermediates از متد computeRoutes در REST یا متد ComputeRoutes در gRPC تعریف کنید.
ایستگاههای بینراهی در مقابل ایستگاههای بینراهی
شما میتوانید یک نقطهی میانی را به عنوان یک توقفگاه یا یک محل عبور پیکربندی کنید:
- توقفگاه : به طور پیشفرض، وسیله نقلیه در محل مورد نظر توقف میکند. هر نقطه توقف، مسیر را با اضافه کردن یک ورودی
RouteLegبه آرایهlegsدر پاسخ، تقسیم میکند. برای اطلاعات بیشتر، به بخش «تنظیم توقف در امتداد یک مسیر» مراجعه کنید. - نقطه مسیر عبوری با تنظیم
"via"رویtrue: وسیله نقلیه بدون توقف از محل عبور میکند. نقاط مسیر عبوری ورودیهایی به آرایهlegsاضافه نمیکنند. برای اطلاعات بیشتر، به تنظیم یک نقطه برای عبور یک مسیر مراجعه کنید.
بخشهای مسیر و نقاط میانی
برای هر توقف میانی در یک درخواست، پاسخ شامل یک شیء RouteLeg جداگانه در آرایه routes.legs است.
برای مثال، مسیری با یک مبدا، یک توقفگاه میانی و یک مقصد، شامل دو بخش مسیر است: * بخش ۱ : از مبدا تا توقفگاه میانی. * بخش ۲ : از توقفگاه میانی تا مقصد.
مثال: درخواست با یک نقطه مسیر میانی
مثال زیر از آرایه intermediates برای اضافه کردن یک توقفگاه میانی به یک مسیر استفاده میکند.
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'
پاسخ با مسیرهای چندگانه
از آنجا که نقطهی میانی در درخواست، یک ایستگاه بینراهی است که "via": true تنظیم نمیکند، پاسخ، مسیر را به دو شاخه در آرایهی legs تقسیم میکند:
{ "routes": [ { "distanceMeters": 805, "duration": "248s", "legs": [ { "distanceMeters": 207, "duration": "89s", "startLocation": { "latLng": { "latitude": 37.4197318, "longitude": -122.0826233 } }, "endLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } } }, { "distanceMeters": 598, "duration": "159s", "startLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } }, "endLocation": { "latLng": { "latitude": 37.4176166, "longitude": -122.0793882 } } } ] } ] }