Shipment Tracking

کلاس FleetEngineShipmentLocationProvider

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

ارائه دهنده محل حمل و نقل

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

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

FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
مولفه های:
یک ارائه دهنده مکان جدید برای ردیابی محموله Fleet Engine ایجاد می کند.
trackingId
نوع: string
شناسه ردیابی برای کاری که این ارائه دهنده مکان مشاهده می کند. این فیلد را برای شروع ردیابی تنظیم کنید.
ارثی: isPolling ، pollingIntervalMillis
refresh
refresh()
پارامترها: ندارد
مقدار برگشتی: void
مکان ردیابی شده را به صراحت بازخوانی می کند.
ارثی: addListener
error
function(event)
استدلال ها:
رویدادی که زمانی فعال می شود که ارائه دهنده موقعیت مکانی با خطا مواجه شود.
update
function(event)
استدلال ها:
رویدادی که پس از اتمام درخواست به‌روزرسانی داده‌های Fleet Engine فعال می‌شود.
ارثی: ispollingchange

رابط FleetEngineShipmentLocationProviderOptions

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

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

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

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

    برای لیستی از پارامترهای ارائه شده و کاربردهای آنها ShipmentPolylineCustomizationFunctionParams را ببینید.
deliveryVehicleMarkerCustomization optional
نوع: (function( ShipmentMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
سفارشی سازی روی نشانگر خودروی تحویل اعمال می شود.

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

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

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

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

تنظیم این مقدار روی 0، بی نهایت یا یک مقدار منفی، به روز رسانی خودکار مکان را غیرفعال می کند. اگر پارامتر شناسه ردیابی (مثلاً شناسه رهگیری محموله ارائه‌دهنده مکان حمل‌ونقل)، یا یک گزینه فیلتر (مثلاً محدوده‌های درگاه دید یا فیلترهای ویژگی برای ارائه‌دهندگان موقعیت ناوگان) تغییر کند، به‌روزرسانی مکان جدید یک بار واکشی می‌شود.

فاصله نظرسنجی پیش فرض و حداقل 5000 میلی ثانیه است. اگر فاصله نظرسنجی را روی مقدار مثبت کمتری تنظیم کنید، 5000 ذخیره و استفاده می شود.
remainingPolylineCustomization optional
نوع: (function( ShipmentPolylineCustomizationFunctionParams ): void)| PolylineOptions optional
سفارشی سازی روی چند خط باقی مانده اعمال شد. چند خط باقی مانده مربوط به بخشی از مسیری است که وسیله نقلیه هنوز از آن عبور نکرده است.

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

    برای لیستی از پارامترهای ارائه شده و کاربردهای آنها ShipmentPolylineCustomizationFunctionParams را ببینید.
takenPolylineCustomization optional
نوع: (function( ShipmentPolylineCustomizationFunctionParams ): void)| PolylineOptions optional
سفارشی سازی روی چند خط گرفته شده اعمال می شود. چند خط گرفته شده مربوط به بخشی از مسیری است که وسیله نقلیه قبلاً از آن عبور کرده است.

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

    برای لیستی از پارامترهای ارائه شده و کاربردهای آنها ShipmentPolylineCustomizationFunctionParams را ببینید.
trackingId optional
نوع: string optional
شناسه ردیابی کار برای ردیابی بلافاصله پس از ارائه دهنده مکان. اگر مشخص نشده باشد، ارائه‌دهنده موقعیت مکانی ردیابی هیچ کاری را شروع نمی‌کند. از FleetEngineShipmentLocationProvider.trackingId برای تنظیم شناسه ردیابی و شروع ردیابی استفاده کنید.

رابط FleetEngineShipmentLocationProviderUpdateEvent

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

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

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