زمانی که بهترین مسیر را برای یک سفر مشترک سواری تعیین می کنید، ممکن است سریع ترین مسیر همیشه بهترین گزینه نباشد. ممکن است بخواهید مسیر خود را برنامه ریزی کنید.
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 است. مسیر فیلد از نوع پیام پاسخ سطح بالا شروع می شود و به صورت اختیاری با یک یا چند نقطه و سپس سطح بعدی نام فیلد دنبال می شود. به طور کلی مسیرهای فیلد به روش زیر ساخته می شوند:
topLevelField[.secondLevelField][.thirdLevelField][...]
یک ماسک فیلد مورد خاص یک علامت عام "*" است که تمام فیلدهای سطح ریشه را انتخاب می کند.
برای اطلاعات بیشتر ببین:
برای مثال‌هایی از استفاده از روش ComputeCustomRoutes ، به مثال‌های محاسبه یک مسیر سفارشی (بتا) مراجعه کنید.
محاسبه عوارض
برای اطلاعات در مورد محاسبه هزینه عوارض، به محاسبه هزینه عوارض مراجعه کنید.
برای مثال‌هایی از محاسبه هزینه‌های عوارض، به محاسبه نمونه‌های مسیر سفارشی مراجعه کنید.