Shipment Tracking

کلاس FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class
extends PollingLocationProvider
library "journeySharing"

ارائه‌دهنده مکان محموله.

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");

سازنده
FleetEngineShipmentLocationProvider	FleetEngineShipmentLocationProvider(options) پارامترها: ‫options: FleetEngineShipmentLocationProviderOptions گزینه‌های ارائه‌دهنده مکان. ارائه‌دهنده مکان جدیدی برای ردیابی محموله Fleet Engine ایجاد می‌کند.

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

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

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

میانای FleetEngineShipmentLocationProviderOptions

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

گزینه‌های ارائه‌دهنده مکان محموله.

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

میانای FleetEngineShipmentLocationProviderUpdateEvent

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

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

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