Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider class

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

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

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

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

مشخصات
deliveryVehicleId	نوع: string شناسه خودرویی که این ارائه‌دهنده مکان مشاهده می‌کند. این فیلد را برای ردیابی خودرو تنظیم کنید.
shouldShowOutcomeLocations	نوع: boolean optional به‌صورت اختیاری به کاربران اجازه دهید مکان نتیجه تکلیف را نمایش دهند.
shouldShowTasks	نوع: boolean optional به‌صورت اختیاری به کاربران اجازه دهید تکالیف واکشی‌شده را نمایش دهند.
staleLocationThresholdMillis	نوع: number این فیلد فقط خواندنی است. آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد.
taskFilterOptions	نوع: FleetEngineTaskFilterOptions گزینه‌های فیلتر را برای اعمال هنگام واکشی تکالیف برمی‌گرداند.
به‌ارث‌رسیده: isPolling، pollingIntervalMillis

روش‌ها
از سازمان بالاتر: addListener

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

میانای FleetEngineDeliveryVehicleLocationProviderOptions

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

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

مشخصات
authTokenFetcher	نوع: AuthTokenFetcher «نشان‌های وب JSON» را برای اصالت‌سنجی مشتری در Fleet Engine ارائه می‌دهد.
projectId	نوع: string شناسه پروژه مصرف‌کننده از «کنسول Google Cloud».
activePolylineCustomization اختیاری	نوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی فعال اعمال شد. چندخطی فعال با بخشی از مسیری که خودرو درحال‌حاضر درحال پیمودن آن است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
deliveryVehicleId اختیاری	نوع: string optional شناسه خودرو تحویل برای ردیابی بلافاصله پس‌از نمونه‌سازی ارائه‌دهنده مکان. اگر مشخص نشده باشد، ارائه‌دهنده مکان ردیابی هیچ خودرویی را شروع نمی‌کند؛ از FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId برای تنظیم شناسه و شروع ردیابی استفاده کنید.
deliveryVehicleMarkerCustomization اختیاری	نوع: (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر خودرو تحویل اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به DeliveryVehicleMarkerCustomizationFunctionParams مراجعه کنید.
plannedStopMarkerCustomization اختیاری	نوع: (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر توقف برنامه‌ریزی‌شده اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به PlannedStopMarkerCustomizationFunctionParams مراجعه کنید.
pollingIntervalMillis اختیاری	نوع: number optional حداقل زمان بین واکشی به‌روزرسانی‌های مکان برحسب میلی‌ثانیه. اگر واکشی به‌روزرسانی مکان بیشتر از pollingIntervalMillis طول بکشد، به‌روزرسانی مکان بعدی تا زمانی که به‌روزرسانی فعلی تمام نشود شروع نمی‌شود. تنظیم این مقدار روی ۰ به‌روزرسانی‌های تکرارشونده مکان را غیرفعال می‌کند. اگر هریک از پارامترهای مشاهده‌شده توسط ارائه‌دهنده مکان تغییر کند، به‌روزرسانی مکان جدیدی واکشی می‌شود. فاصله نظرسنجی پیش‌فرض ۵۰۰۰ میلی‌ثانیه است که حداقل فاصله است. اگر فاصله نظرسنجی را روی مقدار غیرصفر کمتری تنظیم کنید، از ۵۰۰۰ استفاده می‌شود.
remainingPolylineCustomization اختیاری	نوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی باقی‌مانده اعمال شد. چندخطی باقی‌مانده مربوط به بخشی از مسیر است که خودرو هنوز شروع به پیمودن آن نکرده است. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
shouldShowOutcomeLocations اختیاری	نوع: boolean optional مقدار بولی برای نمایش دادن یا پنهان کردن مکان‌های نتیجه برای تکالیف واکشی‌شده.
shouldShowTasks اختیاری	نوع: boolean optional بولی برای نمایش دادن یا پنهان کردن تکالیف. تنظیم این مقدار روی false از فراخوانی نقطه پایانی ListTasks برای واکشی تکالیف جلوگیری می‌کند. فقط ایستگاه‌های پیش‌روی وسیله نقلیه نمایش داده خواهد شد.
staleLocationThresholdMillis اختیاری	نوع: number optional آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد. به‌طور پیش‌فرض ۲۴ ساعت به میلی‌ثانیه است. اگر آستانه کمتر از ۰ یا بی‌نهایت باشد، آستانه نادیده گرفته می‌شود و مکان خودرو قدیمی درنظر گرفته نمی‌شود.
takenPolylineCustomization اختیاری	نوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی گرفته‌شده اعمال شد. چندخطی طی‌شده با بخشی از مسیر که خودرو قبلاً طی کرده است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
taskFilterOptions اختیاری	نوع: FleetEngineTaskFilterOptions optional گزینه‌های فیلتر برای اعمال هنگام واکشی تکالیف. گزینه‌ها می‌تواند شامل خودرو، زمان، و وضعیت تکلیف خاصی باشد.
taskMarkerCustomization اختیاری	نوع: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر تکلیف اعمال شد. نشانگر تکلیف در مکان برنامه‌ریزی‌شده برای هر تکلیف واگذارشده به خودروِ تحویل ارائه می‌شود. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TaskMarkerCustomizationFunctionParams مراجعه کنید.
taskOutcomeMarkerCustomization اختیاری	نوع: function(TaskMarkerCustomizationFunctionParams): void optional سفارشی‌سازی اعمال‌شده بر نشانگر نتیجه تکلیف. نشانگر نتیجه تکلیف در مکان نتیجه واقعی هر تکلیف اختصاص‌داده‌شده به خودرو تحویل ارائه می‌شود. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به TaskMarkerCustomizationFunctionParams مراجعه کنید.

میانای FleetEngineTaskFilterOptions

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

گزینه‌های فیلتر کردن برای تکالیف در «ارائه‌دهنده مکان خودروِ تحویل».

مشخصات
completionTimeFrom اختیاری	نوع: Date optional کران پایین انحصاری برای زمان تکمیل تکلیف. برای فیلتر کردن تکالیفی که پس‌از زمان مشخص‌شده تکمیل شده‌اند استفاده می‌شود.
completionTimeTo اختیاری	نوع: Date optional کران بالای انحصاری برای زمان تکمیل تکلیف. برای فیلتر کردن تکالیفی که قبل‌از زمان مشخص‌شده تکمیل شده‌اند استفاده می‌شود.
state اختیاری	نوع: string optional وضعیت تکلیف. مقادیر معتبر عبارت‌اند از OPEN یا CLOSED.

میانای FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

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

مشخصات
completedVehicleJourneySegments اختیاری	نوع: Array<VehicleJourneySegment> optional بخش‌های سفر که توسط این خودرو تکمیل شده است. غیرقابل‌تغییر.
deliveryVehicle اختیاری	نوع: DeliveryVehicle optional ساختار داده خودروِ تحویل که توسط به‌روزرسانی برگردانده شده است. غیرقابل‌تغییر.
tasks اختیاری	نوع: Array<Task> optional فهرست تکالیفی که این وسیله نقلیه تحویل انجام می‌دهد. غیرقابل‌تغییر.

کلاس FleetEngineDeliveryFleetLocationProvider

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

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

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

سازنده
FleetEngineDeliveryFleetLocationProvider	FleetEngineDeliveryFleetLocationProvider(options) پارامترها: ‫options: FleetEngineDeliveryFleetLocationProviderOptions گزینه‌هایی برای ارسال به ارائه‌دهنده مکان. ارائه‌دهنده مکان جدیدی برای وسایل نقلیه ردیابی‌شده توسط Fleet Engine ایجاد می‌کند.

مشخصات
deliveryVehicleFilter	نوع: string optional فیلتر اعمال‌شده هنگام واکشی کردن خودروهای تحویل.
locationRestriction	نوع: LatLngBounds|LatLngBoundsLiteral optional محدوده‌ای که خودروهای تحویل در آن ردیابی می‌شوند. اگر مرزی تنظیم نشود، هیچ خودروِ تحویلی ردیابی نخواهد شد. برای ردیابی همه وسایل نقلیه تحویل بدون توجه به مکان، مرزهایی معادل کل زمین تنظیم کنید.
staleLocationThresholdMillis	نوع: number این فیلد فقط خواندنی است. آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد.
به‌ارث‌رسیده: isPolling، pollingIntervalMillis

روش‌ها
از سازمان بالاتر: addListener

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

میانای FleetEngineDeliveryFleetLocationProviderOptions

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

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

مشخصات
authTokenFetcher	نوع: AuthTokenFetcher «نشان‌های وب JSON» را برای اصالت‌سنجی مشتری در Fleet Engine ارائه می‌دهد.
projectId	نوع: string شناسه پروژه مصرف‌کننده از «کنسول Google Cloud».
deliveryVehicleFilter اختیاری	نوع: string optional یک پُرسمان فیلتر برای اعمال هنگام واکشی وسایل نقلیه تحویل. این فیلتر مستقیماً به Fleet Engine ارسال می‌شود. برای قالب‌های پشتیبانی‌شده، ListDeliveryVehiclesRequest.filter را ببینید. توجه داشته باشید که فیلترهای معتبر برای مشخصه‌ها باید پیشوند «attributes» داشته باشند. برای مثال، attributes.x = "y" یا attributes."x y" = "z".
deliveryVehicleMarkerCustomization اختیاری	نوع: function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional سفارشی‌سازی روی نشانگر خودرو تحویل اعمال شده است. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به DeliveryVehicleMarkerCustomizationFunctionParams مراجعه کنید.
locationRestriction اختیاری	نوع: LatLngBounds|LatLngBoundsLiteral optional محدوده طول/عرض جغرافیایی که بلافاصله پس‌از نمونه‌سازی ارائه‌دهنده مکان، وسایل نقلیه در آن ردیابی می‌شوند. اگر تنظیم نشده باشد، ارائه‌دهنده مکان ردیابی هیچ خودرویی را شروع نمی‌کند؛ از FleetEngineDeliveryFleetLocationProvider.locationRestriction برای تنظیم حدود و شروع ردیابی استفاده کنید. برای ردیابی همه وسایل نقلیه تحویل بدون توجه به مکان، مرزهایی معادل کل زمین تنظیم کنید.
staleLocationThresholdMillis اختیاری	نوع: number optional آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد. به‌طور پیش‌فرض ۲۴ ساعت به میلی‌ثانیه است. اگر آستانه کمتر از صفر یا بی‌نهایت باشد، آستانه نادیده گرفته می‌شود و مکان خودرو قدیمی درنظر گرفته نخواهد شد.

میانای FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

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

مشخصات
deliveryVehicles اختیاری	نوع: Array<DeliveryVehicle> optional فهرست وسایل نقلیه تحویل که پُرسمان برمی‌گرداند. غیرقابل‌تغییر.