Fleet Tracking - Last Mile Fleet

کلاس FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProvider کلاس google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProvider

ارائه دهنده مکان وسیله نقلیه تحویلی.

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

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

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
مولفه های:
یک ارائه دهنده مکان جدید برای وسیله نقلیه تحویل Fleet Engine ایجاد می کند.
deliveryVehicleId
نوع: string
شناسه وسیله نقلیه که این ارائه دهنده موقعیت مکانی مشاهده می کند. این فیلد را برای ردیابی وسیله نقلیه تنظیم کنید.
shouldShowOutcomeLocations
نوع: boolean optional
به صورت اختیاری به کاربران اجازه می دهد مکان نتیجه کار را نمایش دهند.
shouldShowTasks
نوع: boolean optional
به صورت اختیاری به کاربران اجازه می دهد کارهای واکشی شده را نمایش دهند.
staleLocationThresholdMillis
نوع: number
این فیلد فقط خواندنی است. آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود.
taskFilterOptions
گزینه های فیلتر را برای اعمال در هنگام واکشی وظایف برمی گرداند.
ارثی: isPolling ، pollingIntervalMillis
ارثی: addListener
error
function(event)
استدلال ها:
رویدادی که زمانی فعال می شود که ارائه دهنده موقعیت مکانی با خطا مواجه شود.
update
function(event)
استدلال ها:
رویدادی که پس از اتمام درخواست به‌روزرسانی داده‌های Fleet Engine فعال می‌شود.
ارثی: ispollingchange

رابط FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProviderOptions رابط google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProviderOptions

گزینه هایی برای ارائه دهنده مکان وسیله نقلیه تحویل.

authTokenFetcher
توکن های وب JSON را برای احراز هویت مشتری به Fleet Engine ارائه می دهد.
projectId
نوع: string
شناسه پروژه مصرف کننده از Google Cloud Console.
activePolylineCustomization optional
سفارشی سازی روی چند خط فعال اعمال شد. یک پلی لاین فعال مربوط به بخشی از مسیری است که خودرو در حال حاضر از آن عبور می کند.

از این فیلد برای تعیین استایل سفارشی (مانند رنگ چند خطی) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی PolylineOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد چند خط روی پلی لاین اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر تابعی مشخص شده باشد، زمانی که چند خط ایجاد می شود، یک بار فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که مختصات پلی لاین تغییر می کند، یا زمانی که ارائه دهنده مکان، داده هایی را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این است یا خیر. پلی لاین تغییر کرده است

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
deliveryVehicleId optional
نوع: string optional
شناسه وسیله نقلیه تحویلی برای ردیابی بلافاصله پس از شناسایی ارائه‌دهنده مکان. اگر مشخص نشده باشد، ارائه دهنده مکان ردیابی هیچ وسیله نقلیه ای را شروع نمی کند. از FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId برای تنظیم شناسه و شروع ردیابی استفاده کنید.
deliveryVehicleMarkerCustomization optional
سفارشی سازی روی نشانگر خودروی تحویل اعمال می شود.

از این فیلد برای تعیین استایل سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی MarkerOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد نشانگر بر روی نشانگر اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر یک تابع مشخص شده باشد، قبل از اینکه به نمای نقشه اضافه شود، یک بار هنگام ایجاد نشانگر فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که ارائه دهنده مکان داده ها را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این نشانگر تغییر کرده باشند یا خیر.

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به DeliveryVehicleMarkerCustomizationFunctionParams مراجعه کنید.
plannedStopMarkerCustomization optional
نوع: (function( PlannedStopMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
سفارشی سازی برای نشانگر توقف برنامه ریزی شده اعمال می شود.

از این فیلد برای تعیین استایل سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی MarkerOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد نشانگر بر روی نشانگر اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر یک تابع مشخص شده باشد، قبل از اینکه به نمای نقشه اضافه شود، یک بار هنگام ایجاد نشانگر فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که ارائه دهنده مکان داده ها را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این نشانگر تغییر کرده باشند یا خیر.

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به PlannedStopMarkerCustomizationFunctionParams مراجعه کنید.
pollingIntervalMillis optional
نوع: number optional
حداقل زمان بین واکشی به‌روزرسانی‌های مکان در میلی‌ثانیه. اگر واکشی به‌روزرسانی موقعیت مکانی بیشتر از pollingIntervalMillis طول می‌کشد، به‌روزرسانی موقعیت مکانی بعدی تا زمانی که به‌روزرسانی فعلی به پایان برسد شروع نمی‌شود.

تنظیم این مقدار روی 0، به‌روزرسانی‌های مکرر مکان را غیرفعال می‌کند. اگر هر یک از پارامترهای مشاهده شده توسط ارائه دهنده مکان تغییر کند، به روز رسانی مکان جدید واکشی می شود.

فاصله نظرسنجی پیش فرض 5000 میلی ثانیه است که حداقل فاصله است. اگر فاصله نظرسنجی را روی یک مقدار غیر صفر کمتر تنظیم کنید، 5000 استفاده می شود.
remainingPolylineCustomization optional
سفارشی سازی روی چند خط باقی مانده اعمال شد. چند خط باقی مانده مربوط به بخشی از مسیری است که وسیله نقلیه هنوز از آن عبور نکرده است.

از این فیلد برای تعیین استایل سفارشی (مانند رنگ چند خطی) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی PolylineOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد چند خط روی پلی لاین اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر تابعی مشخص شده باشد، زمانی که چند خط ایجاد می شود، یک بار فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که مختصات پلی لاین تغییر می کند، یا زمانی که ارائه دهنده مکان، داده هایی را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این است یا خیر. پلی لاین تغییر کرده است

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
shouldShowOutcomeLocations optional
نوع: boolean optional
Boolean برای نمایش یا پنهان کردن مکان‌های نتیجه برای وظایف واکشی شده.
shouldShowTasks optional
نوع: boolean optional
Boolean برای نمایش یا پنهان کردن وظایف. تنظیم این روی false از فراخوانی نقطه پایانی ListTasks برای واکشی وظایف جلوگیری می کند. فقط توقف های خودروی آینده نمایش داده می شود.
staleLocationThresholdMillis optional
نوع: number optional
آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی‌شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود. به طور پیش‌فرض 24 ساعت در میلی‌ثانیه تنظیم می‌شود. اگر آستانه کمتر از 0 یا Infinity باشد، آستانه نادیده گرفته می‌شود و مکان وسیله نقلیه قدیمی در نظر گرفته نمی‌شود.
takenPolylineCustomization optional
سفارشی سازی روی چند خط گرفته شده اعمال می شود. چند خط گرفته شده مربوط به بخشی از مسیری است که وسیله نقلیه قبلاً از آن عبور کرده است.

از این فیلد برای تعیین استایل سفارشی (مانند رنگ چند خطی) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی PolylineOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد چند خط روی پلی لاین اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر تابعی مشخص شده باشد، زمانی که چند خط ایجاد می شود، یک بار فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که مختصات پلی لاین تغییر می کند، یا زمانی که ارائه دهنده مکان، داده هایی را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این است یا خیر. پلی لاین تغییر کرده است

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به DeliveryVehiclePolylineCustomizationFunctionParams مراجعه کنید.
taskFilterOptions optional
گزینه های فیلتر برای اعمال در هنگام واکشی وظایف. گزینه ها می توانند شامل خودرو، زمان و وضعیت کار خاص باشند.
taskMarkerCustomization optional
نوع: (function( TaskMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
سفارشی سازی برای نشانگر وظیفه اعمال می شود. یک نشانگر وظیفه در محل برنامه ریزی شده هر وظیفه اختصاص داده شده به وسیله نقلیه تحویل داده می شود.

از این فیلد برای تعیین استایل سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی MarkerOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد نشانگر بر روی نشانگر اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر یک تابع مشخص شده باشد، قبل از اینکه به نمای نقشه اضافه شود، یک بار هنگام ایجاد نشانگر فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که ارائه دهنده مکان داده ها را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این نشانگر تغییر کرده باشند یا خیر.

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به TaskMarkerCustomizationFunctionParams مراجعه کنید.
taskOutcomeMarkerCustomization optional
نوع: function( TaskMarkerCustomizationFunctionParams ): void optional
سفارشی سازی برای نشانگر نتیجه کار اعمال می شود. نشانگر نتیجه کار در محل نتیجه واقعی هر وظیفه اختصاص داده شده به وسیله نقلیه تحویل داده می شود.

از این فیلد برای تعیین استایل سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی MarkerOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد نشانگر بر روی نشانگر اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر یک تابع مشخص شده باشد، قبل از اینکه به نمای نقشه اضافه شود، یک بار هنگام ایجاد نشانگر فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که ارائه دهنده مکان داده ها را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این نشانگر تغییر کرده باشند یا خیر.

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به TaskMarkerCustomizationFunctionParams مراجعه کنید.

رابط FleetEngineTaskFilterOptions

google.maps.journeySharing . FleetEngineTaskFilterOptions رابط google.maps.journeySharing . FleetEngineTaskFilterOptions

گزینه های فیلتر کردن وظایف در ارائه دهنده مکان وسیله نقلیه تحویل.

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

رابط FleetEngineDeliveryVehicleLocationProviderUpdateEvent

google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProviderUpdateEvent رابط google.maps.journeySharing . FleetEngineDeliveryVehicleLocationProviderUpdateEvent

هنگامی که رویداد FleetEngineDeliveryVehicleLocationProvider.update فعال می شود، شی رویداد به کنترل کننده رویداد منتقل می شود.

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

کلاس FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing . FleetEngineDeliveryFleetLocationProvider کلاس google.maps.journeySharing . FleetEngineDeliveryFleetLocationProvider

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

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

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

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
مولفه های:
یک ارائه دهنده مکان جدید برای وسایل نقلیه ردیابی شده توسط Fleet Engine ایجاد می کند.
deliveryVehicleFilter
نوع: string optional
فیلتر هنگام واکشی وسایل نقلیه تحویل اعمال می شود.
locationRestriction
نوع: LatLngBounds | LatLngBoundsLiteral optional
محدوده هایی که در آن باید وسایل نقلیه تحویل را ردیابی کرد. اگر هیچ محدودیتی تعیین نشود، هیچ وسیله نقلیه تحویلی ردیابی نخواهد شد. برای ردیابی همه وسایل نقلیه تحویل بدون توجه به مکان، محدوده هایی را معادل کل زمین تعیین کنید.
staleLocationThresholdMillis
نوع: number
این فیلد فقط خواندنی است. آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود.
ارثی: isPolling ، pollingIntervalMillis
ارثی: addListener
update
function(event)
استدلال ها:
رویدادی که پس از اتمام درخواست به‌روزرسانی داده‌های Fleet Engine فعال می‌شود.
ارثی: ispollingchange

رابط FleetEngineDeliveryFleetLocationProviderOptions

google.maps.journeySharing . FleetEngineDeliveryFleetLocationProviderOptions رابط google.maps.journeySharing . FleetEngineDeliveryFleetLocationProviderOptions

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

authTokenFetcher
توکن های وب JSON را برای احراز هویت مشتری به Fleet Engine ارائه می دهد.
projectId
نوع: string
شناسه پروژه مصرف کننده از Google Cloud Console.
deliveryVehicleFilter optional
نوع: string optional
یک درخواست فیلتر برای اعمال هنگام واکشی وسایل نقلیه تحویل. این فیلتر مستقیماً به Fleet Engine منتقل می شود.

برای فرمت های پشتیبانی شده به ListDeliveryVehiclesRequest.filter مراجعه کنید.

توجه داشته باشید که فیلترهای معتبر برای ویژگی ها باید دارای پیشوند "ویژگی ها" باشند. به عنوان مثال، attributes.x = "y" یا attributes."x y" = "z" .
deliveryVehicleMarkerCustomization optional
نوع: function( DeliveryVehicleMarkerCustomizationFunctionParams ): void optional
سفارشی‌سازی برای نشانگر وسیله نقلیه تحویلی اعمال می‌شود.

از این فیلد برای تعیین استایل سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید.
  • اگر یک شی MarkerOptions مشخص شده باشد، تغییرات مشخص شده در آن پس از ایجاد نشانگر بر روی نشانگر اعمال می شود و در صورت وجود گزینه های پیش فرض آن بازنویسی می شود.
  • اگر یک تابع مشخص شده باشد، قبل از اینکه به نمای نقشه اضافه شود، یک بار هنگام ایجاد نشانگر فراخوانی می شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم می شود.) علاوه بر این، این تابع زمانی فراخوانی می شود که ارائه دهنده مکان داده ها را از Fleet Engine دریافت می کند، صرف نظر از اینکه داده های مربوط به این نشانگر تغییر کرده باشند یا خیر.

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها به DeliveryVehicleMarkerCustomizationFunctionParams مراجعه کنید.
locationRestriction optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
محدوده طول و عرض جغرافیایی که در آن ردیابی وسایل نقلیه بلافاصله پس از معرفی ارائه دهنده مکان انجام می شود. اگر تنظیم نشود، ارائه‌دهنده موقعیت مکانی ردیابی هیچ وسیله نقلیه‌ای را شروع نمی‌کند. از FleetEngineDeliveryFleetLocationProvider.locationRestriction برای تعیین محدوده و شروع ردیابی استفاده کنید. برای ردیابی همه وسایل نقلیه تحویل بدون توجه به مکان، محدوده هایی را معادل کل زمین تعیین کنید.
staleLocationThresholdMillis optional
نوع: number optional
آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی‌شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود. به طور پیش‌فرض 24 ساعت در میلی‌ثانیه تنظیم می‌شود. اگر آستانه کمتر از صفر یا Infinity باشد، آستانه نادیده گرفته می‌شود و مکان وسیله نقلیه قدیمی در نظر گرفته نمی‌شود.

رابط FleetEngineDeliveryFleetLocationProviderUpdateEvent

google.maps.journeySharing . FleetEngineDeliveryFleetLocationProviderUpdateEvent رابط google.maps.journeySharing . FleetEngineDeliveryFleetLocationProviderUpdateEvent

هنگامی که رویداد FleetEngineDeliveryFleetLocationProvider.update فعال می شود، شی رویداد به کنترل کننده رویداد منتقل می شود.

deliveryVehicles optional
نوع: Array < DeliveryVehicle > optional
لیست وسایل نقلیه تحویلی که توسط پرس و جو برگشت داده شده است. غیر قابل تغییر