Trip and Order Progress

کلاس FleetEngineTripLocationProvider

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

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

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

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

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
مولفه های:
یک ارائه دهنده مکان جدید برای سفر Fleet Engine ایجاد می کند.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
مولفه های:
ارزش بازگشتی: ندارد
تابع سفارشی سازی Polyline که چند خط فعال را با توجه به سرعت خواندن آن رنگ می کند. این تابع را به عنوان FleetEngineTripLocationProviderOptions.activePolylineCustomization تعیین کنید تا یک خط چند خطی آگاه از ترافیک را برای چند خط فعال ارائه کنید.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
مولفه های:
ارزش بازگشتی: ندارد
تابع سفارشی سازی Polyline که چند خط باقی مانده را با توجه به سرعت خواندن آن رنگ می کند. این تابع را به عنوان FleetEngineTripLocationProviderOptions.remainingPolylineCustomization تعیین کنید تا یک چند خط آگاه از ترافیک برای چند خط باقیمانده ارائه شود.
tripId
نوع: string
شناسه سفری که این ارائه دهنده مکان مشاهده می کند. این فیلد را برای شروع ردیابی تنظیم کنید.
ارثی: isPolling ، pollingIntervalMillis
refresh
refresh()
پارامترها: ندارد
مقدار برگشتی: void
مکان ردیابی شده را به صراحت بازخوانی می کند.
ارثی: addListener
error
function(event)
استدلال ها:
رویدادی که زمانی فعال می شود که ارائه دهنده موقعیت مکانی با خطا مواجه شود.
update
function(event)
استدلال ها:
رویدادی که پس از اتمام درخواست به‌روزرسانی داده‌های Fleet Engine فعال می‌شود.
ارثی: ispollingchange

رابط FleetEngineTripLocationProviderOptions

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

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

authTokenFetcher
توکن های وب JSON را برای احراز هویت مشتری به Fleet Engine ارائه می دهد.
projectId
نوع: string
شناسه پروژه مصرف کننده از Google Cloud Console.
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 طول می‌کشد، به‌روزرسانی موقعیت مکانی بعدی تا زمانی که به‌روزرسانی فعلی به پایان برسد شروع نمی‌شود.

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

فاصله نظرسنجی پیش فرض 5000 میلی ثانیه است که حداقل فاصله است. اگر فاصله نظرسنجی را روی یک مقدار غیر صفر کمتر تنظیم کنید، 5000 استفاده می شود.
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 رابط google.maps.journeySharing . FleetEngineTripLocationProviderUpdateEvent

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

trip optional
نوع: Trip optional
ساختار سفر با به روز رسانی بازگشت. غیر قابل تغییر