Route Optimization API تکالیف و مسیرها را به ناوگان خودرو اختصاص میدهد و آنها را براساس اهداف و محدودیتهایی که ارائه میدهید، مانند پنجرههای زمانی، ظرفیت خودرو، ساعات رانندگی، و هزینهها، بهینهسازی میکند. شما آن را ازطریق REST، gRPC، یا کتابخانههای کارخواه فراخوانی میکنید و این API توالیهای بازدید، واگذاریهای محموله، زمانهای تخمینی، و سنجههای مسیر را برمیگرداند.
Route Optimization API: key facts
- محصول: Route Optimization API
- همچنین شناختهشده با نام: GMPRO
- دسته: مسیرها
- پلاتفرم: سرویس وب (REST)
- اجرا در: سرور (کد پسین)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی Route Optimization API
Route Optimization API: زمان استفاده از آن
در موارد زیر از Route Optimization API استفاده کنید:
- باید محمولهها یا تکالیف را به چندین وسیله نقلیه اختصاص دهید و درعینحال پنجرههای زمانی، ظرفیت وسیله نقلیه، ساعات رانندگی، و هزینهها را رعایت کنید.
- به بهترین توالی توقف برای یک خودرو با چند سوار کردن، تحویل، یا قرار نیاز دارید.
- باید مسیرهای فعال را برای سفارشهای جدید (مثل ارسال درخواستی) بااستفاده از
injectedFirstSolutionRoutesیاinjectedSolutionConstraintدوباره بهینهسازی کنید. - برای هر بخش از طرح بهینهشده، به توکنهای مسیر نیاز دارید تا به کیت توسعه نرمافزار ناوبری ارسال کنید.
در شرایط زیر از Route Optimization API استفاده نکنید:
- به ردیابی زنده نحوه اجرای طرح توسط رانندگان نیاز دارید؛ API چندخطیهای برنامهریزیشده را برمیگرداند، نه مسیرهای همزمان خودرو. درعوض از سرویس Fleet Engine استفاده کنید.
- به راهنمایی گامبهگام درونبرنامهای برای رانندگان درطول مسیر بهینهشده نیاز دارید. درعوض از کیت توسعه نرمافزار ناوبری برای Android استفاده کنید.
- برای رانندگان در iOS درطول مسیر بهینهسازیشده به راهنمایی گامبهگام درونبرنامهای نیاز دارید. درعوض از کیت توسعه نرمافزار ناوبری برای iOS استفاده کنید.
Route Optimization API: setup
- سرویس برای فعال کردن:
routeoptimization.googleapis.com - اصالتسنجی: OAuth 2.0، حساب سرویس
- شروع به کار: راهاندازی Route Optimization API
- مرجع: مرجع Route Optimization API
- قیمتگذاری: استفاده و صدور صورتحساب Route Optimization API
- خطمشیها: خطمشیهای Route Optimization API
- یادداشتهای انتشار: یادداشتهای انتشار Route Optimization API
بستههای رسمی Route Optimization API:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - برو:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار ناوبری برای Android، کیت توسعه نرمافزار ناوبری برای iOS، سرویس Fleet Engine، Maps JavaScript API
Route Optimization API: اشتباهات رایج
- مشکل: برای تماسهای REST به نقطه پایانی مسدودکننده
OptimizeTours، مهلت پیشفرض ۶۰ ثانیهای بر هرtimeoutمتن درخواست بزرگتر از ۶۰ ثانیه اولویت دارد. راهحل: برای تمدید مهلت، سرصفحهX-Server-Timeout(ثانیه، بدون پسوند «s») را تنظیم کنید. کتابخانههای کارخواه و gRPC بهطور پیشفرض روی ۳۶۰۰ ثانیه تنظیم شدهاند. /maps/documentation/route-optimization/timeouts را ببینید. - مشکل: مقادیر
timeoutو مهلت به ۱۸۰۰ ثانیه محدود شده است. اصلاح:allowLargeDeadlineDespiteInterruptionRiskرا رویtrueتنظیم کنید تا حداکثر ۳۶۰۰ ثانیه مجاز شود و خطر خطاهای وقفه را بپذیرید. /maps/documentation/route-optimization/timeouts را ببینید. - مشکل: بدون پارامترهای هزینه (برای مثال
costPerHourیاcostPerKilometer)، بهینهساز با همه راهحلها بهطور یکسان برخورد میکند. اصلاح: پارامترهای هزینه را در خودروهایی تعریف کنید که هزینههای کسبوکارتان را منعکس میکنند. /maps/documentation/route-optimization/make-first-request را ببینید. - مشکل: درخواستهای اصالتسنجیشده با کلید میانای برنامهسازی کاربردی ناموفق است؛ هر درخواست به کد OAuth نیاز دارد. راهحل: از یک توکن OAuth با دامنه
https://www.googleapis.com/auth/cloud-platformاستفاده کنید، مثلاً ازطریق «اطلاعات کاربری پیشفرض برنامه» یا حساب سرویس. /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token را ببینید.
کارهایی که میتوانید با Route Optimization API انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- برگرداندن طرح تحویل چندایستگاهی، بهینهسازیشده براساس محدودیتهای مشخصشده برای مسیریابی، هزینه، محموله، و خودرو.
- زمان شروع و پایان هر توقف را در طرح تحویل بهینهشده برگردانید.
- مدت زمان سفر، تأخیر، استراحت، و انتظار بین هر توقف را در طرح تحویل بهینهشده برگردانید.
- اطلاعات بار خودرو را در هر توقف در طرح بهینهسازیشده ارسال برگردانید.
- اطلاعات هزینه برگرداندن کالا برای هر محموله در طرح ارسال بهینهسازیشده.
- چندخطی کدگذاریشدهای را برای مسیر بین هر ایستگاه در طرح تحویل بهینهسازیشده برمیگرداند.
- یک کد مسیر ناوبری برای مسیر بین هر توقف در یک طرح تحویل بهینهشده برگردانید.
- سنجههای مجموع محموله، خودرو، و هزینه را برای طرح تحویل بهینهشده برگردانید.
- پنجره زمانی شروع و پایان را برای طرح تحویل چندایستگاهی مشخص کنید.
- زمان شروع و پایان دردسترس بودن و مکانهای هر خودرو را در طرح تحویل چندایستگاهی مشخص کنید.
- هزینههای زمانی خودرو را برای هر خودرو در طرح تحویل چندایستگاهی مشخص کنید.
- پارامترهای مدل هزینه را برای طرح تحویل چندایستگاهی مشخص کنید.
- محدودیتهای زمانی تحویل و دریافت را برای هر محموله در طرح تحویل چندایستگاهی مشخص کنید.
- تخصیص خودرو را برای طرح تحویل چندایستگاهی مشخص کن.
- حدود بار را برای هر خودرو در طرح تحویل چندایستگاهی مشخص کنید.
- مشخص کنید که آیا اطلاعات ترافیک زنده برای طرح تحویل چندایستگاهی درنظر گرفته شود یا نه.
- درخواست بهینهسازی طرح تحویل چندایستگاهی را بهصورت دستهای پردازش کنید و پاسخ را در Google Cloud Storage بنویسید.
- قبلاز تحویل دادن، برای پارک کردن وقت بگذارید.
- بازدیدهای نزدیک را اولویتبندی کنید تا پشتسرهم انجام شوند.
- از دور کامل زدن در مسیر خودرو چندایستگاهی اجتناب کنید. آزمایشی توجه: ویژگی آزمایشی؛ مشمول شرایط و محدودیتهای پیشاز دردسترس عموم.
- برای اهداف ازپیش تعریفشده بهینهسازی کنید. آزمایشی توجه: ویژگی آزمایشی؛ مشمول شرایط و محدودیتهای پیشاز دردسترس عموم.
- محمولههای سنگینتر را اول تحویل دهید. آزمایشی توجه: ویژگی آزمایشی؛ مشمول شرایط و محدودیتهای پیشاز دردسترس عموم.