Fleet Tracking - On Demand Rides & Delivery

کلاس FleetEngineVehicleLocationProvider

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

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

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

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

روش‌های ایستا
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) پارامترها: params: VehiclePolylineCustomizationFunctionParams پارامترهای ارائه‌شده به تابع سفارشی‌سازی چندخطی. مقدار برگشتی: هیچ تابع سفارشی‌سازی چندخطی که چندخطی فعال را براساس سرعت خواندن آن رنگ‌آمیزی می‌کند. این تابع را به‌عنوان FleetEngineVehicleLocationProviderOptions.activePolylineCustomization مشخص کنید تا چندخطی آگاه از ترافیک را برای چندخطی فعال ارائه دهد.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) پارامترها: params: VehiclePolylineCustomizationFunctionParams پارامترهای ارائه‌شده به تابع سفارشی‌سازی چندخطی. مقدار برگشتی: هیچ عملکرد سفارشی‌سازی چندخطی که باقی چندخطی را براساس سرعت خواندن آن رنگ‌آمیزی می‌کند. این تابع را به‌عنوان FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization مشخص کنید تا چندخطی آگاه از ترافیک برای چندخطی باقی‌مانده ارائه شود.

مشخصات
staleLocationThresholdMillis	نوع: number این فیلد فقط خواندنی است. آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد.
vehicleId	نوع: string شناسه خودرویی که این ارائه‌دهنده مکان مشاهده می‌کند. این فیلد را برای ردیابی خودرو تنظیم کنید.
به‌ارث‌رسیده: isPolling، pollingIntervalMillis

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

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

میانای FleetEngineVehicleLocationProviderOptions

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

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

مشخصات
authTokenFetcher	نوع: AuthTokenFetcher «نشان‌های وب JSON» را برای اصالت‌سنجی مشتری در Fleet Engine ارائه می‌دهد.
projectId	نوع: string شناسه پروژه مصرف‌کننده از «کنسول Google Cloud».
activePolylineCustomization اختیاری	نوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی فعال اعمال شد. چندخطی فعال با بخشی از مسیری که خودرو درحال‌حاضر درحال پیمودن آن است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehiclePolylineCustomizationFunctionParams مراجعه کنید.
destinationMarkerCustomization اختیاری	نوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی بر نشانگر مقصد سفر خودرو اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehicleWaypointMarkerCustomizationFunctionParams مراجعه کنید.
intermediateDestinationMarkerCustomization اختیاری	نوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگرهای مقصد میانی سفر خودرو اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehicleWaypointMarkerCustomizationFunctionParams مراجعه کنید.
originMarkerCustomization اختیاری	نوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر مبدأ سفر خودرو اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehicleWaypointMarkerCustomizationFunctionParams مراجعه کنید.
pollingIntervalMillis اختیاری	نوع: number optional حداقل زمان بین واکشی به‌روزرسانی‌های مکان برحسب میلی‌ثانیه. اگر واکشی به‌روزرسانی مکان بیشتر از pollingIntervalMillis طول بکشد، به‌روزرسانی مکان بعدی تا زمانی که به‌روزرسانی فعلی تمام نشود شروع نمی‌شود. تنظیم این مقدار روی ۰ به‌روزرسانی‌های تکرارشونده مکان را غیرفعال می‌کند. اگر هریک از پارامترهای مشاهده‌شده توسط ارائه‌دهنده مکان تغییر کند، به‌روزرسانی مکان جدیدی واکشی می‌شود. فاصله نظرسنجی پیش‌فرض ۵۰۰۰ میلی‌ثانیه است که حداقل فاصله است. اگر فاصله نظرسنجی را روی مقدار غیرصفر کمتری تنظیم کنید، از ۵۰۰۰ استفاده می‌شود.
remainingPolylineCustomization اختیاری	نوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی باقی‌مانده اعمال شد. چندخطی باقی‌مانده مربوط به بخشی از مسیر است که خودرو هنوز شروع به پیمودن آن نکرده است. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehiclePolylineCustomizationFunctionParams مراجعه کنید.
staleLocationThresholdMillis اختیاری	نوع: number optional آستانه برای مکان خودرو قدیمی. اگر آخرین مکان به‌روزشده خودرو قدیمی‌تر از این آستانه باشد، خودرو نمایش داده نخواهد شد. به‌طور پیش‌فرض ۲۴ ساعت به میلی‌ثانیه است. اگر آستانه کمتر از ۰ یا بی‌نهایت باشد، آستانه نادیده گرفته می‌شود و مکان خودرو قدیمی درنظر گرفته نمی‌شود.
takenPolylineCustomization اختیاری	نوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional سفارشی‌سازی روی چندخطی گرفته‌شده اعمال شد. چندخطی طی‌شده با بخشی از مسیر که خودرو قبلاً طی کرده است مطابقت دارد. از این فیلد برای مشخص کردن سبک سفارشی (مانند رنگ چندخطی) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء PolylineOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد چندخطی روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، هنگام ایجاد چندخطی یک‌بار فراخوانی می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که مختصات چندخطی تغییر کند، یا زمانی که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این چندخطی تغییر کرده باشد یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehiclePolylineCustomizationFunctionParams مراجعه کنید.
vehicleId اختیاری	نوع: string optional شناسه خودرو برای ردیابی بلافاصله پس‌از نمونه‌سازی ارائه‌دهنده مکان. اگر مشخص نشده باشد، ارائه‌دهنده مکان ردیابی هیچ خودرویی را شروع نمی‌کند؛ از FleetEngineVehicleLocationProvider.vehicleId برای تنظیم شناسه و شروع ردیابی استفاده کنید.
vehicleMarkerCustomization اختیاری	نوع: (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional سفارشی‌سازی روی نشانگر خودرو اعمال شد. از این فیلد برای مشخص کردن سبک سفارشی (مانند نماد نشانگر) و تعامل (مانند مدیریت کلیک) استفاده کنید. اگر شیء MarkerOptions مشخص شده باشد، تغییرات مشخص‌شده در آن پس‌از ایجاد نشانگر روی آن اعمال می‌شود و گزینه‌های پیش‌فرض آن را (درصورت وجود) بازنویسی می‌کند. اگر تابعی مشخص شده باشد، یک‌بار هنگام ایجاد نشانگر و قبل‌از اضافه شدن آن به نمای نقشه فراخوانده می‌شود. (در این فراخوانی، پارامتر isNew در شیء پارامترهای تابع روی true تنظیم شده است.) علاوه‌براین، این تابع زمانی فراخوانی می‌شود که ارائه‌دهنده مکان داده‌ها را از Fleet Engine دریافت کند، صرف‌نظر از اینکه داده‌های مربوط به این نشانگر تغییر کرده باشند یا نه. برای مشاهده فهرست پارامترهای ارائه‌شده و کاربردهای آن‌ها، به VehicleMarkerCustomizationFunctionParams مراجعه کنید.

میانای FleetEngineVehicleLocationProviderUpdateEvent

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

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

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

کلاس FleetEngineFleetLocationProvider

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

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

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

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

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

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

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

میانای FleetEngineFleetLocationProviderOptions

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

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

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

میانای FleetEngineFleetLocationProviderUpdateEvent

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

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

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