با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA).
Route Optimization API دو روش را نشان می دهد:
OptimizeTours یک روش همزمان است که یک مسیر بهینه شده را در پاسخ به OptimizeToursRequest برمی گرداند. مشتریان باید تا زمانی که درخواست پردازش شود و OptimizeToursResponse یا خطا برگردانده شود، یک اتصال باز به Route Optimization API حفظ کنند.
BatchOptimizeTours یک روش ناهمزمان است که URI ها را برای یک یا چند OptimizeToursRequest و پیام OptimizeToursResponse مربوطه می پذیرد و نام منبع یک عملیات طولانی مدت (LRO) ( REST ، gRPC ) را که برای بررسی تکمیل دسته ای استفاده می شود، برمی گرداند. OptimizeToursRequest ها در پس زمینه پردازش می شوند، بنابراین کلاینت ها اتصالات باز به Route Optimization API را فقط به اندازه کافی برای ارسال BatchOptimizeToursRequest یا تماس با GetOperation برای بررسی وضعیت LRO حفظ می کنند. BatchOptimizeTours درخواست‌ها را از Google Cloud Storage می‌خواند و پاسخ‌ها را می‌نویسد.
موارد استفاده کنید
OptimizeTours برای حل درخواست های کوچک و ساده یا برای درخواست هایی با زمان حل چند دقیقه یا کمتر مناسب است. حفظ اتصالات طولانی مدت به Route Optimization API خطر وقفه را قبل از بازگشت راه حل افزایش می دهد.
BatchOptimizeTours می‌تواند درخواست‌ها و درخواست‌های بزرگ‌تر را با زمان حل طولانی‌تر رسیدگی کند، زیرا نیازی به اتصال طولانی‌مدت به Route Optimization API ندارد.
عملیات طولانی مدت
LROها از Route Optimization API با استفاده از روش GetOperation برای بررسی وضعیت تکمیل یک دسته خوانده می شوند. LRO ها شامل یک ویژگی done است که نشان می دهد آیا پردازش کل دسته کامل شده است یا خیر و یک فیلد error که خطاهای رخ داده در طول پردازش را گزارش می دهد. اگر done درست باشد و error وجود نداشته باشد، دسته با موفقیت کامل شد. وجود یک error نشان می دهد که برخی یا همه پردازش دسته ای ناموفق است.
چرخه عمر معمول درخواست BatchOptimizeTours به شرح زیر است:
یک BatchOptimizeToursRequest به Route Optimization API ارسال کنید، که نام منبع یک LRO را برمی گرداند.
نظرسنجی GetOperation با نام منبع LRO برگردانده تا زمانی که خصوصیات done یا error در پاسخ LRO ظاهر شود.
اگر done درست است و هیچ خطایی وجود ندارد، OptimizeToursResponses از URI های Google Cloud Storage مشخص شده در درخواست BatchOptimizeTours بخوانید. اگر error وجود داشت، خطا را بررسی کنید، OptimizeToursRequest را بر این اساس در Google Cloud Storage به‌روزرسانی کنید و بسته به خطای مشاهده‌شده، در صورت لزوم دوباره امتحان کنید.
می‌توانید درخواست‌های OptimizeTours و BatchOptimizeTours را به روش‌های مختلفی ارسال کنید، یا از خط فرمان یا با استفاده از کتابخانه مشتری.
تاریخ آخرین به‌روزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Route Optimization API offers two methods: \u003ccode\u003eOptimizeTours\u003c/code\u003e for synchronous processing of smaller, simpler requests and \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e for asynchronous handling of larger, more complex requests.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOptimizeTours\u003c/code\u003e requires an open connection until a response is received, while \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e utilizes Google Cloud Storage for requests and responses, enabling background processing.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eBatchOptimizeTours\u003c/code\u003e relies on Long Running Operations (LROs) to track batch progress, which can be monitored via the \u003ccode\u003eGetOperation\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eWhen using \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e, users should submit the request, poll for completion using the LRO, and retrieve results or address errors as indicated by the LRO status.\u003c/p\u003e\n"]]],[],null,["# Synchronous and asynchronous endpoints\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\nThe Route Optimization API exposes two methods:\n\n- `OptimizeTours` is a *synchronous* method that returns an optimized route in response to an `OptimizeToursRequest`. Clients must maintain an open connection to the Route Optimization API until the request is processed and an `OptimizeToursResponse` or error is returned.\n- `BatchOptimizeTours` is an *asynchronous* method that accepts URIs for one or more `OptimizeToursRequest` and corresponding `OptimizeToursResponse` messages, returning the resource name of a *Long Running Operation* (LRO) ([REST](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation), [gRPC](/maps/documentation/route-optimization/reference/rpc/google.longrunning#google.longrunning.Operations))) that is used to check for batch completion. `OptimizeToursRequest`s are processed in the background, so clients maintain an open connections to the Route Optimization API only long enough to submit the `BatchOptimizeToursRequest` or to call `GetOperation` to check LRO status. `BatchOptimizeTours` reads requests from and writes responses to [Google Cloud Storage](https://cloud.google.com/storage).\n\nUse cases\n---------\n\n`OptimizeTours` is convenient for solving small and simple requests, or for\nrequests with solving times of a few minutes or less. Maintaining long-lived\nconnections to the Route Optimization API increases risk of interruption before\na solution can be returned.\n\n`BatchOptimizeTours` can handle larger requests and requests with longer solving\ntime because it does not require a long-lived connection to the Route\nOptimization API.\n\nLong running operations\n-----------------------\n\nLROs are read from the Route Optimization API using the `GetOperation` method to\ncheck the completion status of a batch. LROs include a `done` property that\nindicates whether processing of the entire batch is complete and an `error`\nfield that reports errors encountered during processing. If `done` is true and\nno `error` is present, the batch completed successfully. The presence of an\n`error` indicates that some or all of the batch failed processing.\n| **Note:** REST `GetOperation` responses omit the `done` property if its value is false and the `error` property if no errors occurred.\n\nThe typical lifecycle of a `BatchOptimizeTours` request is as follows:\n\n1. Submit a `BatchOptimizeToursRequest` to the Route Optimization API, which returns the resource name of an LRO.\n2. Poll `GetOperation` with the returned LRO resource name until the `done` or `error` properties appear in the LRO response.\n3. If `done` is true and no error is present, read `OptimizeToursResponses` from the Google Cloud Storage URIs specified in the `BatchOptimizeTours` request. If `error` is present, inspect the error, update the `OptimizeToursRequest`s accordingly in Google Cloud Storage, and retry as appropriate depending on the observed error.\n\nYou can send `OptimizeTours` and `BatchOptimizeTours` requests in a variety of\nways, either from the command line or using a client library.\n\n[Next: Make an API Request](/maps/documentation/route-optimization/make-request)"]]
