مرجع سریع Route Optimization API

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

بسته‌های رسمی 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: اشتباهات رایج

  • مشکل: برای تماس‌های 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 انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.