با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
زمانی که بهترین مسیر را برای یک سفر مشترک سواری تعیین می کنید، ممکن است سریع ترین مسیر همیشه بهترین گزینه نباشد. ممکن است بخواهید مسیر خود را برنامه ریزی کنید.
Routes Preferred API به شما امکان می دهد یک مسیر را با تعیین یک هدف مسیر با استفاده از روش ComputeCustomRoutes برنامه ریزی کنید.
روش ComputeCustomRoutes همچنین می تواند با به حداقل رساندن تفاوت بین مسیر انتخاب شده توسط اپراتور و مسیر هدایت شده، به انطباق مسیر کمک کند.
از Routes Preferred API و Navigation SDK برای درک کامل مزایای برنامه ریزی مسیر استفاده کنید.
متد ComputeCustomRoutes را فعال کنید
قبل از اینکه بتوانید از متد ComputeCustomRoutes در کد خود استفاده کنید، باید آن را فعال کنید. برای اطلاعات بیشتر در مورد فعال کردن روش‌های API ترجیحی مسیرها، به شروع به کار مراجعه کنید.
از روش ComputeCustomRoutes استفاده کنید
روش ComputeCustomRoutes مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا fields$fields ، یا با استفاده از هدر HTTP/gRPC X-Goog-FieldMask ارائه دهید. برای اطلاعات بیشتر، به پارامترهای سیستم مراجعه کنید.
مقدار ماسک فیلد لیستی از مسیرهای فیلد جدا شده با کاما است. هر مسیر فیلد لیستی از نام فیلدهای جدا شده با نقطه است که نشان دهنده سلسله مراتب پیام است. نام فیلد یا کلید شی JSON یا نام تگ فیلد protobuf است. مسیر فیلد از نوع پیام پاسخ سطح بالا شروع می شود و به صورت اختیاری با یک یا چند نقطه و سپس سطح بعدی نام فیلد دنبال می شود. به طور کلی مسیرهای فیلد به روش زیر ساخته می شوند:
تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Routes Preferred API's \u003ccode\u003eComputeCustomRoutes\u003c/code\u003e method enables planning routes based on objectives beyond the fastest route, such as compliance or driver preferences.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eComputeCustomRoutes\u003c/code\u003e supports optimizing routes for \u003ccode\u003eDRIVE\u003c/code\u003e and \u003ccode\u003eTWO_WHEELER\u003c/code\u003e travel modes, but excludes intermediate waypoints and other travel modes.\u003c/p\u003e\n"],["\u003cp\u003eUsing the Routes Preferred API with the Navigation SDK provides the best route planning outcomes, though they can utilize separate cloud projects.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the \u003ccode\u003eComputeCustomRoutes\u003c/code\u003e method, enable it and verify your quota limits, requesting increases if necessary through Google Cloud Support.\u003c/p\u003e\n"],["\u003cp\u003eTo specify desired data in the response, use field masks with the \u003ccode\u003eComputeCustomRoutes\u003c/code\u003e method, selecting fields using dot-separated paths from the top-level response.\u003c/p\u003e\n"]]],["The Routes Preferred API's `ComputeCustomRoutes` method allows route planning by specifying a route objective and minimizing deviations from the operator's selected route. This method supports `DRIVE` and `TWO_WHEELER` travel modes, excluding `via` waypoints. To use it, enable the method and specify a response field mask via `$fields`, `fields`, or `X-Goog-FieldMask`. Quota limits should be monitored. Use alongside the Navigation SDK to maximize route planning benefits. Additionally, toll fees can be calculated using this API.\n"],null,[]]
