Fleet Tracking - On Demand Rides & Delivery (beta)

کلاس FleetEngineVehicleLocationProvider

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

ارائه دهنده مکان خودرو

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

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

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

رابط FleetEngineVehicleLocationProviderOptions

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

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

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

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehiclePolylineCustomizationFunctionParams را ببینید.
destinationMarkerCustomization optional
سفارشی سازی برای نشانگر مقصد سفر وسیله نقلیه اعمال می شود.

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehicleWaypointMarkerCustomizationFunctionParams را ببینید.
intermediateDestinationMarkerCustomization optional
سفارشی سازی برای نشانگرهای مقصد میانی سفر وسیله نقلیه اعمال می شود.

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehicleWaypointMarkerCustomizationFunctionParams را ببینید.
originMarkerCustomization optional
سفارشی سازی برای نشانگر مبدا سفر وسیله نقلیه اعمال می شود.

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

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

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

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

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehiclePolylineCustomizationFunctionParams را ببینید.
staleLocationThresholdMillis optional
نوع: number optional
آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی‌شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود. به طور پیش فرض 24 ساعت در میلی ثانیه تنظیم می شود. اگر آستانه کمتر از 0 یا Infinity باشد، آستانه نادیده گرفته می‌شود و مکان وسیله نقلیه قدیمی در نظر گرفته نمی‌شود.
takenPolylineCustomization optional
نوع: (function( VehiclePolylineCustomizationFunctionParams ): void)| PolylineOptions optional
سفارشی سازی روی چند خط گرفته شده اعمال می شود. چند خط گرفته شده مربوط به بخشی از مسیری است که وسیله نقلیه قبلاً از آن عبور کرده است.

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehiclePolylineCustomizationFunctionParams را ببینید.
vehicleId optional
نوع: string optional
شناسه وسیله نقلیه برای ردیابی بلافاصله پس از شناسایی ارائه‌دهنده مکان. اگر مشخص نشده باشد، ارائه دهنده مکان ردیابی هیچ وسیله نقلیه ای را شروع نمی کند. از FleetEngineVehicleLocationProvider.vehicleId برای تنظیم شناسه و شروع ردیابی استفاده کنید.
vehicleMarkerCustomization optional
نوع: (function( VehicleMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
سفارشی سازی روی نشانگر خودرو اعمال می شود.

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehicleMarkerCustomizationFunctionParams را ببینید.

رابط FleetEngineVehicleLocationProviderUpdateEvent

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

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

trips optional
نوع: Array < Trip > optional
لیست سفرهای انجام شده توسط این وسیله نقلیه. غیر قابل تغییر
vehicle optional
نوع: Vehicle optional
ساختار داده خودرو که توسط به روز رسانی بازگردانده شده است. غیر قابل تغییر

کلاس FleetEngineFleetLocationProvider

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

ارائه دهنده مکان ناوگان.

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

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

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

رابط FleetEngineFleetLocationProviderOptions

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

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

authTokenFetcher
توکن های وب JSON را برای احراز هویت مشتری به Fleet Engine ارائه می دهد.
projectId
نوع: string
شناسه پروژه مصرف کننده از Google Cloud Console.
locationRestriction optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
محدوده طول و عرض جغرافیایی که در آن ردیابی وسایل نقلیه بلافاصله پس از معرفی ارائه دهنده مکان انجام می شود. اگر تنظیم نشود، ارائه‌دهنده موقعیت مکانی ردیابی هیچ وسیله نقلیه‌ای را شروع نمی‌کند. از FleetEngineFleetLocationProvider.locationRestriction برای تعیین محدوده و شروع ردیابی استفاده کنید. برای ردیابی همه وسایل نقلیه بدون توجه به موقعیت مکانی، محدوده هایی را معادل کل زمین تعیین کنید.
staleLocationThresholdMillis optional
نوع: number optional
آستانه برای مکان ماشین قدیمی اگر آخرین مکان به‌روزرسانی شده برای وسیله نقلیه قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نمی‌شود. به طور پیش‌فرض 24 ساعت در میلی‌ثانیه تنظیم می‌شود. اگر آستانه کمتر از صفر یا Infinity باشد، آستانه نادیده گرفته می‌شود و مکان وسیله نقلیه قدیمی در نظر گرفته نمی‌شود.
vehicleFilter optional
نوع: string optional
یک درخواست فیلتر برای اعمال هنگام واکشی وسایل نقلیه. این فیلتر مستقیماً به Fleet Engine منتقل می شود.

برای فرمت های پشتیبانی شده ListVehiclesRequest.filter را ببینید.

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

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

    برای لیستی از پارامترهای ارائه شده و موارد استفاده از آنها VehicleMarkerCustomizationFunctionParams را ببینید.

رابط FleetEngineFleetLocationProviderUpdateEvent

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

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

vehicles optional
نوع: Array < Vehicle > optional
لیست وسایل نقلیه بازگردانده شده توسط پرس و جو. غیر قابل تغییر