Trip and Order Progress

کلاس FleetEngineTripLocationProvider

‫google.maps.journeySharing.FleetEngineTripLocationProvider کلاس

ارائه‌دهنده مکان سفر.

این کلاس PollingLocationProvider را گسترش می‌دهد.

با تماس با const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

سازنده
FleetEngineTripLocationProvider	FleetEngineTripLocationProvider(options) پارامترها:  ‫options:  FleetEngineTripLocationProviderOptions گزینه‌های ارائه‌دهنده مکان. ارائه‌دهنده مکان جدیدی برای سفر Fleet Engine ایجاد می‌کند.

روش‌های ایستا
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) پارامترها:  params:  TripPolylineCustomizationFunctionParams پارامترهای ارائه‌شده به تابع سفارشی‌سازی چندخطی. مقدار برگشتی:  هیچ تابع سفارشی‌سازی چندخطی که چندخطی فعال را براساس سرعت خواندن آن رنگ‌آمیزی می‌کند. این تابع را به‌عنوان FleetEngineTripLocationProviderOptions.activePolylineCustomization مشخص کنید تا چندخطی آگاه از ترافیک را برای چندخطی فعال ارائه دهد.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) پارامترها:  params:  TripPolylineCustomizationFunctionParams پارامترهای ارائه‌شده به تابع سفارشی‌سازی چندخطی. مقدار برگشتی:  هیچ عملکرد سفارشی‌سازی چندخطی که باقی چندخطی را براساس سرعت خواندن آن رنگ‌آمیزی می‌کند. این تابع را به‌عنوان FleetEngineTripLocationProviderOptions.remainingPolylineCustomization مشخص کنید تا چندخطی آگاه از ترافیک برای چندخطی باقی‌مانده ارائه شود.

مشخصات
tripId	نوع:  string شناسه سفری که این ارائه‌دهنده مکان مشاهده می‌کند. برای شروع ردیابی، این فیلد را تنظیم کنید.
به‌ارث‌رسیده: isPolling، pollingIntervalMillis

روش‌ها
refresh	refresh() پارامترها:  هیچ مقدار برگشتی:  void مکان ردیابی‌شده را به‌طور صریح بازآوری می‌کند.
از سازمان بالاتر: addListener

رویدادها
error	function(event) متغیرهای مستقل:  ‫event:  ErrorEvent رویدادی که وقتی ارائه‌دهنده مکان با خطا مواجه می‌شود راه‌اندازی می‌شود.
update	function(event) متغیرهای مستقل:  ‫event:  FleetEngineTripLocationProviderUpdateEvent رویدادی که وقتی درخواست به‌روزرسانی داده Fleet Engine تمام می‌شود راه‌اندازی می‌شود.
از سازمان بالاتر: ispollingchange

میانای FleetEngineTripLocationProviderOptions

میانا google.maps.journeySharing.FleetEngineTripLocationProviderOptions

گزینه‌های ارائه‌دهنده مکان سفر.

مشخصات
authTokenFetcher	نوع:  AuthTokenFetcher «نشان‌های وب JSON» را برای اصالت‌سنجی مشتری در Fleet Engine ارائه می‌دهد.
projectId	نوع:  string شناسه پروژه مصرف‌کننده از «کنسول Google Cloud».
activePolylineCustomization optional	نوع:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی فعال اعمال شد. چندخطی فعال با بخشی از مسیری که خودرو درحال‌حاضر درحال پیمودن آن است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripPolylineCustomizationFunctionParams مراجعه کنید.
destinationMarkerCustomization optional	نوع:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر مقصد اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripMarkerCustomizationFunctionParams مراجعه کنید.
originMarkerCustomization optional	نوع:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر مبدأ اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripMarkerCustomizationFunctionParams مراجعه کنید.
pollingIntervalMillis optional	نوع:  number optional حداقل زمان بین واکشی به‌روزرسانی‌های مکان برحسب میلی‌ثانیه. اگر واکشی به‌روزرسانی مکان بیشتر از pollingIntervalMillis طول بکشد، به‌روزرسانی مکان بعدی تا زمانی که به‌روزرسانی فعلی تمام نشود شروع نمی‌شود. تنظیم این مقدار روی ۰ به‌روزرسانی‌های تکرارشونده مکان را غیرفعال می‌کند. اگر هریک از پارامترهای مشاهده‌شده توسط ارائه‌دهنده مکان تغییر کند، به‌روزرسانی مکان جدیدی واکشی می‌شود. فاصله نظرسنجی پیش‌فرض ۵۰۰۰ میلی‌ثانیه است که حداقل فاصله است. اگر فاصله نظرسنجی را روی مقدار غیرصفر کمتری تنظیم کنید، از ۵۰۰۰ استفاده می‌شود.
remainingPolylineCustomization optional	نوع:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی باقی‌مانده اعمال شد. چندخطی باقی‌مانده مربوط به بخشی از مسیر است که خودرو هنوز شروع به پیمودن آن نکرده است. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripPolylineCustomizationFunctionParams مراجعه کنید.
takenPolylineCustomization optional	نوع:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی گرفته‌شده اعمال شد. چندخطی طی‌شده با بخشی از مسیر که خودرو قبلاً طی کرده است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripPolylineCustomizationFunctionParams مراجعه کنید.
tripId optional	نوع:  string optional شناسه سفر برای ردیابی بلافاصله پس‌از نمونه‌سازی ارائه‌دهنده مکان. اگر مشخص نشده باشد، ارائه‌دهنده مکان ردیابی هیچ سفری را شروع نمی‌کند؛ از FleetEngineTripLocationProvider.tripId برای تنظیم شناسه و شروع ردیابی استفاده کنید.
vehicleMarkerCustomization optional	نوع:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر خودرو اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripMarkerCustomizationFunctionParams مراجعه کنید.
waypointMarkerCustomization optional	نوع:  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی اعمال‌شده روی نشانگر نقطه‌مسیر. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TripWaypointMarkerCustomizationFunctionParams مراجعه کنید.

میانای FleetEngineTripLocationProviderUpdateEvent

میانا google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

شیء رویداد هنگام راه‌اندازی رویداد FleetEngineTripLocationProvider.update به گرداننده رویداد منتقل شد.

مشخصات
trip optional	نوع:  Trip optional ساختار سفر که توسط به‌روزرسانی برگردانده شده است. غیرقابل‌تغییر.