Route Optimization API چیست؟
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). Route Optimization یک API پلتفرم نقشه های گوگل است که برنامه های مسیر بهینه شده را برای یک یا چند وسیله نقلیه و توقف آنها ایجاد می کند.
چرا از Route Optimization API استفاده کنیم؟
با کمک برنامه های مسیر، کارایی عملیاتی ناوگان حمل و نقل خود را بهبود بخشید. مسیرهای خود را برای هزینه، محدودیت های زمانی، نیازهای مشتری و هر هدف تجاری دیگری تنظیم کنید. به عنوان مثال:
- یک شرکت لجستیکی می‌تواند با برنامه‌ریزی ارسال‌های روز بعد در زمان و منابع صرفه‌جویی کند و در عین حال تحویل‌ها را برای کارایی زمان، صرفه‌جویی در هزینه، تحویل به‌موقع، و رضایت راننده و مشتری نهایی بهینه‌سازی کند.
- یک شرکت تحویل غذای درخواستی می‌تواند با انتخاب بهترین راننده فعال برای دریافت سفارش‌های جدید و درج آنها در مسیرهای موجود، فرآیند ارسال خود را سریع‌تر و مؤثرتر کند.
- یک ارائه‌دهنده خدمات میدانی می‌تواند کارایی و رضایت مشتری خود را با اختصاص دادن به ارائه‌دهندگان در قرار ملاقات‌ها و یافتن ترتیب توقف بهینه برای بیش از یک قرار، بهبود بخشد، در حالی که در هنگام بروز چالش‌ها، مسیرها را مجدداً بهینه می‌کند.
کارهایی که می توانید با Route Optimization API انجام دهید
از Route Optimization API برای بهینه‌سازی مسیرها و وظایف ناوگان خود بر اساس اهداف و محدودیت‌های خود استفاده کنید.
- اهداف: اهداف تجاری شما
- محدودیت ها: محدودیت های دارایی های فیزیکی شما.
| اهداف | محدودیت ها |
|---|
| کارایی سفر | مسیرهای اصلی سفر را با استفاده از پارامترهایی مانند فاصله و زمان تا مقصد بهینه کنید. | ساعت کار رانندگان | تعیین مسیر برای رانندگان بر اساس ساعات کاری و استراحت. |
| ورود به موقع | تحویل، تحویل یا خدمات را برای رسیدن قبل از زمان مشخصی در اولویت قرار دهید. | ظرفیت وسیله نقلیه | یک وسیله نقلیه را بر اساس میزان باری که می تواند حمل کند به یک کار اختصاص دهید. |
| هزینه استفاده از وسیله نقلیه | تعداد وسایل نقلیه مورد نیاز برای انجام یک کار را به حداقل برسانید. | پنجره های زمانی | محموله یا وظیفه در یک بازه زمانی خاص برسد. |
| تعادل بار | وظایف را به طور عادلانه در میان ناوگان وسایل نقلیه و پرسنل توزیع کنید. | وابستگی ها و سازگاری | مسیرهای ناوگان خود را بر اساس نوع وسیله نقلیه، ترتیب کار یا شرایط حمل و نقل خود بهینه کنید. |
Route Optimization API چگونه کار می کند
Route Optimization API را می توان با استفاده از REST , gRPC و کتابخانه های سرویس گیرنده دسترسی داشت .
درخواست بدن
سازمان درخواست اطلاعات مربوط به محموله های شما و وسایل نقلیه موجود برای تحویل آنها را می پذیرد. این شامل جزئیاتی مانند:
- مکان های تحویل و تحویل
- پنجره های زمانی
- اندازه و وزن محموله
- ظرفیت وسیله نقلیه
بدن پاسخگو
بدن پاسخگویی یک برنامه مسیر دقیق ارائه می دهد که شامل:
- توالی توقف ها
- محموله های تعیین شده
- معیارهای کلی
جزئیات بیشتر درباره ساخت یک درخواست را در Construct a Request Message و تفسیر پاسخ در Interpret the Response بخوانید.
منابع
جدول زیر منابع موجود از طریق Route Optimization API را به همراه داده هایی که برمی گرداند خلاصه می کند.
| منابع داده | توضیحات و داده ها برگردانده شد | فرمت بازگشت |
|---|
optimizeTours | این روش یک مسیر بهینه شده را با جزئیات بازدیدها و معیارها برمی گرداند. | پروتو JSON یا gRPC |
batchOptimizeTours | این روش نام منبع یک عملیات طولانی مدت را برمی گرداند که نشان می دهد چه زمانی پردازش کامل شده است. | پروتو JSON یا gRPC |
نحوه استفاده از Route Optimization API
| 1 | راه اندازی شود | با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید. |
| 2 | یک درخواست اولیه را اجرا کنید و پاسخ دریافت کنید | پس از راه اندازی، با ارسال یک درخواست اولیه شروع کنید و پاسخ را دریافت کنید، به دنبال ساخت یک درخواست و تفسیر پاسخ . |
| 3 | سناریوی پیشرفته تری را امتحان کنید و شروع به ایجاد درخواست خود کنید | سناریوهای مثالی را که با بهینه‌سازی سفارش توقف تحویل و تحویل شروع می‌شود کاوش کنید و درخواست‌هایی را شروع کنید که مطابق با موارد استفاده شما باشد. |
کتابخانه های مشتری موجود
برای فهرستی از کتابخانه های سرویس گیرنده موجود برای Route Optimization API، به کتابخانه های سرویس گیرنده مراجعه کنید.
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRoute Optimization API leverages Google Maps data and custom parameters to generate efficient routes for fleets, considering factors like time, cost, and vehicle capacity.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses like logistics companies, on-demand delivery services, and field service providers can use the API to automate dispatch, optimize delivery routes, and improve overall operational efficiency.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers synchronous and asynchronous options for route calculation and provides detailed route plans with assigned tasks, vehicle routes, and performance metrics.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define objectives such as travel efficiency, on-time arrival, and load balancing, along with constraints like driver work hours and vehicle capacity for tailored optimization.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, set up a Google Cloud project, construct a basic request, and explore advanced scenarios to create customized route optimization solutions.\u003c/p\u003e\n"]]],["The Route Optimization API optimizes routes for single or multiple vehicles, enhancing operational efficiency. Users define business objectives (e.g., travel efficiency, on-time arrival) and constraints (e.g., driver hours, vehicle capacity) to guide the optimization. The API accepts shipment and vehicle details, such as locations, time windows, and capacity. It returns a detailed route plan with stop sequences and assigned shipments via JSON or gRPC. Users can construct requests and interpret responses using provided guidelines and resources.\n"],null,["# What is the Route Optimization API\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\nRoute Optimization is a Google Maps Platform API that generates optimized route\nplans for single or multiple vehicles and their stops.\n\nWhy use the Route Optimization API\n----------------------------------\n\nImprove the operational efficiency of your transportation fleet with the help of\nroute plans. Adjust your routes for cost, time constraints, customer needs, and\nany other business objective. For example:\n\n- A **logistics company** can save time and resources by scheduling next-day shipments while optimizing the deliveries for time efficiency, cost saving, on-time delivery, and driver and end customer satisfaction.\n- An **on-demand food delivery** company can make their dispatch process quicker and more effective by choosing the best active driver to pick up new orders and inserting them in their existing routes.\n- A **field service provider** can improve their efficiency and customer satisfaction by assigning providers to appointments and finding the optimal stop sequence for more than one appointment, all while re-optimizing routes when challenges come up.\n\nWhat you can do with the Route Optimization API\n-----------------------------------------------\n\nUse Route Optimization API to optimize your fleet's routes and tasks\nassignments based on your own *objectives* and\n*constraints*.\n\n- **Objectives:** Your business goals.\n- **Constraints:** The limitations of your physical assets.\n\n| Objectives || Constraints ||\n|-----------------------|--------------------------------------------------------------------------------------|------------------------------------|---------------------------------------------------------------------------------------------------|\n| **Travel efficiency** | Optimize basic travel routes using parameters like distance and time-to-destination. | **Drivers work hours** | Assign routes to drivers based on their work hours and breaks. |\n| **On-time arrival** | Prioritize a pickup, delivery, or service to arrive before a specific time. | **Vehicle capacity** | Assign a vehicle to a task based on the amount of load it can carry. |\n| **Vehicle use cost** | Minimize the number of vehicles required to perform a task. | **Time windows** | Have a shipment or task arrive in a specific time slot. |\n| **Load balancing** | Fairly distribute tasks across a fleet of vehicles and personnel. | **Dependencies and compatibility** | Optimize your fleet routes based on your types of vehicle, task sequence, or shipment conditions. |\n\nHow the Route Optimization API works\n------------------------------------\n\nThe Route Optimization API can be accessed using [REST](/maps/documentation/route-optimization/reference/rest/v1/operations), [gRPC](/maps/documentation/route-optimization/reference/rpc), and\n[client libraries](/maps/documentation/route-optimization/client-libraries).\n\n### Request body\n\nThe request body accepts information about your shipments and the vehicles\navailable to deliver them. This includes details such as:\n\n- Pickup and delivery locations\n- Time windows\n- Shipment size and weight\n- Vehicle capacity\n\n### Response body\n\nThe response body provides a detailed route plan which includes:\n\n- Sequence of stops\n- Assigned shipments\n- Overall metrics\n\nRead more details about constructing a request in [Construct a Request\nMessage](/maps/documentation/route-optimization/construct-request)\nand interpreting a response in [Interpret the\nResponse](/maps/documentation/route-optimization/interpret-response).\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoute Optimization API along with the data it returns.\n\n| **Data resources** | **Description and data returned** | **Return format** |\n|----------------------|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `optimizeTours` | This method returns an optimized route, with details of the visits and metrics. | [JSON](/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours) or [gRPC proto](/maps/documentation/route-optimization/reference/rpc/google.maps.routeoptimization.v1#google.maps.routeoptimization.v1.RouteOptimization.OptimizeTours) |\n| `batchOptimizeTours` | This method returns the resource name of a Long Running Operation, which indicates when processing is complete. | [JSON](/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours) or [gRPC proto](/maps/documentation/route-optimization/reference/rpc/google.maps.routeoptimization.v1#google.maps.routeoptimization.v1.RouteOptimization.BatchOptimizeTours) |\n\nHow to use the Route Optimization API\n-------------------------------------\n\n|---|----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/route-optimization/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Run a basic request and receive a response** | After setup, start with sending a basic request and get the response, following [Construct a Request](/maps/documentation/route-optimization/construct-request) and [Interpret the Response](/maps/documentation/route-optimization/interpret-response). |\n| 3 | **Try a more advanced scenario and start creating your own request** | Explore example scenarios starting with [Pickup and Delivery Stop Order Optimization](/maps/documentation/route-optimization/pickup-delivery-order-optimization) and start building requests that match your use cases. |\n\n### Available client libraries\n\nFor a list of the available client libraries for Route Optimization API, see\n[Client Libraries](/maps/documentation/route-optimization/client-libraries).\n\nWhat's next\n-----------\n\n- **Start using the Route Optimization API** : Go to [Run a Basic Request](/maps/documentation/route-optimization/construct-request).\n- **Understand billing** : [Usage and Billing](/maps/documentation/route-optimization/usage-and-billing)\n- **See sample code and libraries** : [Client Libraries](/maps/documentation/route-optimization/client-libraries) and [Open Source](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-routeoptimization).\n- **Follow best practices** : [Best Practices Using Route Optimization API Web\n Services](/maps/documentation/route-optimization/web-service-best-practices)"]]
