وقتی در حال تعیین بهترین مسیر برای یک سفر اشتراکی هستید، سریع‌ترین مسیر ممکن است همیشه بهترین گزینه نباشد. شاید بخواهید مسیر خود را برنامه‌ریزی کنید.
API مربوط به Routes Preferred به شما امکان می‌دهد با مشخص کردن یک هدف مسیر با استفاده از متد ComputeCustomRoutes یک مسیر را برنامه‌ریزی کنید.
متد ComputeCustomRoutes همچنین می‌تواند با به حداقل رساندن تفاوت بین مسیر انتخاب شده توسط اپراتور و مسیر رانده شده، به انطباق مسیر کمک کند.
برای بهره‌مندی کامل از برنامه‌ریزی مسیر، از هر دو API مسیرها (Routes Preferred API) و SDK ناوبری (Navigation SDK) استفاده کنید.
فعال کردن متد ComputeCustomRoutes
قبل از اینکه بتوانید از متد ComputeCustomRoutes در کد خود استفاده کنید، باید آن را فعال کنید. برای اطلاعات بیشتر در مورد فعال کردن متدهای API مربوط به Routes Preferred، به بخش شروع به کار مراجعه کنید.
از متد ComputeCustomRoutes استفاده کنید
متد ComputeCustomRoutes مستلزم آن است که شما یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL $fields یا fields یا با استفاده از هدر HTTP/gRPC X-Goog-FieldMask ارائه دهید. برای اطلاعات بیشتر، به پارامترهای سیستم مراجعه کنید.
مقدار ماسک فیلد، فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. هر مسیر فیلد، فهرستی از نام‌های فیلد است که با نقطه از هم جدا شده‌اند و سلسله مراتب پیام را نشان می‌دهند. نام فیلد یا کلید شیء JSON است یا نام برچسب فیلد protobuf. مسیر فیلد از نوع پیام پاسخ سطح بالا شروع می‌شود و به صورت اختیاری با یک یا چند نقطه و سپس سطح بعدی نام فیلد دنبال می‌شود. به طور کلی، مسیرهای فیلد به روش زیر ساخته می‌شوند:
topLevelField[.secondLevelField][.thirdLevelField][...]
یک ماسک فیلد حالت خاص، یک علامت اختصاری "*" است که تمام فیلدهای سطح ریشه را انتخاب می‌کند.
برای اطلاعات بیشتر، مراجعه کنید به:
برای مثال‌هایی از استفاده از متد ComputeCustomRoutes ، به بخش «محاسبه یک مسیر سفارشی (بتا) مثال‌ها» مراجعه کنید.
محاسبه هزینه عوارض
برای کسب اطلاعات در مورد محاسبه هزینه عوارض، به بخش محاسبه هزینه عوارض مراجعه کنید.
برای مثال‌هایی از محاسبه هزینه‌های عوارض، به محاسبه نمونه‌های مسیر سفارشی مراجعه کنید.