Fleet Engine Entities

میانای تکلیف

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

جزئیات تکلیفی که Fleet Engine برگردانده است.

مشخصات
attributes	نوع: Object<string, *> مشخصه‌های اختصاص‌داده‌شده به تکلیف.
name	نوع: string نام تکلیف در قالب «providers/{provider_id}/tasks/{task_id}». ‫task_id باید شناسه یکتا باشد و شناسه ردیابی نباشد. برای ذخیره کردن شناسه رهگیری محموله، از فیلد tracking_id استفاده کنید. چندین تکلیف می‌توانند tracking_id یکسانی داشته باشند.
remainingVehicleJourneySegments	نوع: Array<VehicleJourneySegment> اطلاعات مربوط به بخش‌هایی که برای این تکلیف باقی مانده است.
status	نوع: string وضعیت اجرای فعلی تکلیف.
type	نوع: string نوع تکلیف؛ برای مثال، استراحت یا ارسال.
estimatedCompletionTime اختیاری	نوع: Date optional مُهر زمانِ زمان تکمیل تخمینی تکلیف.
latestVehicleLocationUpdate اختیاری	نوع: VehicleLocationUpdate optional اطلاعات مختص به آخرین به‌روزرسانی مکان.
outcome اختیاری	نوع: string optional نتیجه تکلیف.
outcomeLocation اختیاری	نوع: LatLngLiteral optional مکانی که تکلیف در آن تکمیل شده است (از ارائه‌دهنده).
outcomeLocationSource اختیاری	نوع: string optional تنظیم‌کننده مکان نتیجه تکلیف («PROVIDER» یا «LAST_VEHICLE_LOCATION»).
outcomeTime اختیاری	نوع: Date optional مُهر زمان مربوط به وقتی که نتیجه تکلیف تنظیم شده است (از ارائه‌دهنده).
plannedLocation اختیاری	نوع: LatLngLiteral optional مکانی که تکلیف باید در آن تکمیل شود.
targetTimeWindow اختیاری	نوع: TimeWindow optional بازه زمانی که تکلیف باید در آن تکمیل شود.
trackingId اختیاری	نوع: string optional شناسه رهگیری مرسوله.
vehicleId اختیاری	نوع: string optional شناسه خودرویی که این تکلیف را انجام می‌دهد.

TaskInfo interface

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

نوع TaskInfo، استفاده‌شده توسط DeliveryVehicleStop.

مشخصات
extraDurationMillis اختیاری	نوع: number optional زمان اضافه‌ای که برای انجام تکلیف لازم است، برحسب میلی‌ثانیه.
id اختیاری	نوع: string optional شناسه تکلیف.
targetTimeWindow اختیاری	نوع: TimeWindow optional بازه زمانی که تکلیف باید در آن تکمیل شود.

TaskTrackingInfo میانای

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

جزئیات شیء اطلاعات ردگیری تکلیف که توسط Fleet Engine برگردانده شده است.

مشخصات
attributes	نوع: Object<string, *> مشخصه‌های اختصاص‌داده‌شده به تکلیف.
name	نوع: string نام در قالب «providers/{provider_id}/taskTrackingInfo/{tracking_id}» که در آن tracking_id نشان‌دهنده شناسه رهگیری است.
trackingId	نوع: string شناسه رهگیری «تکلیف». باید رشته یونی‌کد معتبری باشد. حداکثر می‌تواند ۶۴ نویسه باشد. طبق فرم نرمال‌سازی یونی‌کد C نرمال‌سازی شده است. نباید حاوی هیچ‌یک از نویسه‌های ASCII زیر باشد: «/»، «:»، «؟»، «،»، یا «#».
estimatedArrivalTime اختیاری	نوع: Date optional زمان تخمینی رسیدن به مکان ایستگاه.
estimatedTaskCompletionTime اختیاری	نوع: Date optional زمان تکمیل تخمینی «تکلیف».
latestVehicleLocationUpdate اختیاری	نوع: VehicleLocationUpdate optional اطلاعات مختص به آخرین به‌روزرسانی مکان.
plannedLocation اختیاری	نوع: LatLng optional مکانی که «تکلیف» در آن تکمیل خواهد شد.
remainingDrivingDistanceMeters اختیاری	نوع: number optional کل مسافت باقی‌مانده به متر تا VehicleStop موردنظر.
remainingStopCount اختیاری	نوع: number optional تعداد توقف‌های باقی‌مانده خودرو تا رسیدن به توقف تکلیف را نشان می‌دهد، ازجمله توقف تکلیف. برای مثال، اگر ایستگاه بعدی خودرو ایستگاه تکلیف باشد، مقدار ۱ خواهد بود.
routePolylinePoints اختیاری	نوع: Array<LatLng> optional فهرستی از نقاط که وقتی به هم متصل می‌شوند، چندخطی مسیر موردانتظار خودرو به مکان این تکلیف را تشکیل می‌دهند.
state اختیاری	نوع: string optional وضعیت اجرای فعلی «تکلیف».
targetTimeWindow اختیاری	نوع: TimeWindow optional بازه زمانی که تکلیف باید در آن تکمیل شود.
taskOutcome اختیاری	نوع: string optional نتیجه تلاش برای اجرای «تکلیف».
taskOutcomeTime اختیاری	نوع: Date optional زمانی که نتیجه «تکلیف» توسط ارائه‌دهنده تنظیم شده است.

میانای سفر

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

جزئیات سفر برگردانده‌شده توسط Fleet Engine.

مشخصات
name	نوع: string در قالب «providers/{provider_id}/trips/{trip_id}». ‫trip_id باید شناسه یکتایی باشد.
passengerCount	نوع: number تعداد مسافران این سفر؛ شامل راننده نمی‌شود.
remainingWaypoints	نوع: Array<VehicleWaypoint> آرایه‌ای از نقطه‌مسیرها که مسیر از مکان فعلی تا نقطه پیاده کردن را نشان می‌دهد.
status	نوع: string وضعیت فعلی سفر. مقادیر ممکن عبارتند از UNKNOWN_TRIP_STATUS،‏ NEW،‏ ENROUTE_TO_PICKUP،‏ ARRIVED_AT_PICKUP،‏ ARRIVED_AT_INTERMEDIATE_DESTINATION،‏ ENROUTE_TO_INTERMEDIATE_DESTINATION،‏ ENROUTE_TO_DROPOFF،‏ COMPLETE، یا CANCELED.
type	نوع: string نوع سفر. مقادیر ممکن عبارت‌اند از UNKNOWN_TRIP_TYPE،‏ SHARED، یا EXCLUSIVE.
vehicleId	نوع: string شناسه خودرویی که این سفر را انجام می‌دهد.
actualDropOffLocation اختیاری	نوع: LatLngLiteral optional مکانی که مشتری در آنجا پیاده شده است.
actualPickupLocation اختیاری	نوع: LatLngLiteral optional مکانی که مشتری سوار شده است.
dropOffTime اختیاری	نوع: Date optional زمان برآوردی در آینده که مسافران پیاده خواهند شد، یا زمان واقعی که پیاده شدند.
latestVehicleLocationUpdate اختیاری	نوع: VehicleLocationUpdate optional اطلاعات مختص به آخرین به‌روزرسانی مکان.
pickupTime اختیاری	نوع: Date optional زمان تخمینی آینده که مسافران سوار خواهند شد، یا زمان واقعی که سوار شدند.
plannedDropOffLocation اختیاری	نوع: LatLngLiteral optional مکانی که مشتری نشان می‌دهد در آنجا پیاده خواهد شد.
plannedPickupLocation اختیاری	نوع: LatLngLiteral optional مکانی که مشتری نشان می‌دهد از آنجا سوار خواهد شد.

میانای DeliveryVehicle

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

جزئیات خودروِ تحویل کالا که توسط Fleet Engine برگردانده شده است.

مشخصات
attributes	نوع: Object<string, string optional> مشخصه‌های سفارشی خودرو تحویل.
name	نوع: string در قالب «providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}». ‫delivery_vehicle_id باید شناسه یکتایی باشد.
navigationStatus	نوع: string وضعیت ناوبری فعلی خودرو.
remainingDistanceMeters	نوع: number مسافت رانندگی باقی‌مانده در بخش مسیر فعلی، به متر.
remainingVehicleJourneySegments	نوع: Array<VehicleJourneySegment> بخش‌های سفر اختصاص‌داده‌شده به این خودرو تحویل، که از آخرین مکان گزارش‌شده خودرو شروع می‌شود. این مورد فقط زمانی درج می‌شود که شیء داده DeliveryVehicle ازطریق FleetEngineDeliveryVehicleLocationProvider ارائه شده باشد.
currentRouteSegmentEndPoint اختیاری	نوع: LatLngLiteral optional مکانی که بخش مسیر فعلی در آن به‌پایان می‌رسد.
latestVehicleLocationUpdate اختیاری	نوع: VehicleLocationUpdate optional آخرین مکان گزارش‌شده خودرو تحویل.
remainingDurationMillis اختیاری	نوع: number optional مدت رانندگی باقی‌مانده در بخش مسیر فعلی، برحسب میلی‌ثانیه.

میانای DeliveryVehicleStop

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

نوع DeliveryVehicleStop

مشخصات
tasks	نوع: Array<TaskInfo> فهرست «تکالیفی» که باید در این ایستگاه انجام شود. ‫id: شناسه تکلیف. extraDurationMillis: زمان اضافه‌ای که برای انجام تکلیف لازم است، به میلی‌ثانیه.
plannedLocation اختیاری	نوع: LatLngLiteral optional مکان ایستگاه.
state اختیاری	نوع: DeliveryVehicleStopState optional وضعیت توقف.

ثابت‌های DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState ثابت‌ها
کتابخانه "journeySharing"

وضعیت کنونی DeliveryVehicleStop.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع DeliveryVehicleStopStateString تعریف می‌شوند.

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

ثابت‌ها
ARRIVED	به ایستگاه رسید. فرض می‌کند که وقتی خودرو درحال مسیریابی به ایستگاه بعدی است، همه ایستگاه‌های قبلی تکمیل شده‌اند.
ENROUTE	واگذارشده و درحال مسیریابی فعال.
NEW	ایجاد شده است، اما به‌طور فعال مسیریابی نمی‌کند.
UNSPECIFIED	ناشناس.

میانای VehicleJourneySegment

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

نوع VehicleJourneySegment

مشخصات
drivingDistanceMeters اختیاری	نوع: number optional مسافت سفر از ایستگاه قبلی تا این ایستگاه، به متر.
drivingDurationMillis اختیاری	نوع: number optional مدت سفر از ایستگاه قبلی به این ایستگاه، برحسب میلی‌ثانیه.
path اختیاری	نوع: Array<LatLngLiteral> optional مسیر از ایستگاه قبلی (یا مکان فعلی خودرو، اگر این ایستگاه اولین ایستگاه در فهرست ایستگاه‌ها باشد) به این ایستگاه.
stop اختیاری	نوع: DeliveryVehicleStop optional اطلاعات مربوط به ایستگاه.

میانای VehicleLocationUpdate

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

نوع VehicleLocationUpdate

مشخصات
heading اختیاری	نوع: number optional عنوان به‌روزرسانی. ۰ معادل شمال و ۱۸۰ معادل جنوب است.
location اختیاری	نوع: LatLngLiteral|LatLng optional مکان به‌روزرسانی.
speedKilometersPerHour اختیاری	نوع: number optional سرعت برحسب کیلومتر در ساعت.
time اختیاری	نوع: Date optional زمانی که این به‌روزرسانی از خودرو دریافت شد.

میانای VehicleWaypoint

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

نوع VehicleWaypoint.

مشخصات
distanceMeters اختیاری	نوع: number optional فاصله مسیر بین نقطه‌مسیر قبلی (یا مکان فعلی خودرو، اگر این نقطه‌مسیر اولین نقطه‌مسیر در فهرست نقطه‌مسیرها باشد) تا این نقطه‌مسیر برحسب متر.
durationMillis اختیاری	نوع: number optional مدت سفر بین نقطه‌مسیر قبلی (یا مکان فعلی خودرو، اگر این نقطه‌مسیر اولین نقطه‌مسیر در فهرست نقطه‌مسیرها باشد) تا این نقطه‌مسیر برحسب میلی‌ثانیه.
location اختیاری	نوع: LatLngLiteral optional مکان نقطه‌مسیر.
path اختیاری	نوع: Array<LatLngLiteral> optional مسیر از نقطه‌مسیر قبلی (یا مکان فعلی خودرو، اگر این نقطه‌مسیر اولین نقطه‌مسیر در فهرست نقطه‌مسیرها باشد) به این نقطه‌مسیر.
speedReadingIntervals اختیاری	نوع: Array<SpeedReadingInterval> optional فهرست سرعت‌های ترافیک درطول مسیر از نقطه‌مسیر قبلی (یا مکان خودرو) تا نقطه‌مسیر فعلی. هر بازه در فهرست، ترافیک را در یک بخش مجاور در مسیر توصیف می‌کند؛ بازه، نقاط شروع و پایان بخش را ازطریق نمایه‌های آن‌ها تعریف می‌کند. برای جزئیات بیشتر، تعریف SpeedReadingInterval را ببینید.

میانای خودرو

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

جزئیات خودرویی که Fleet Engine برگردانده است.

مشخصات
attributes	نوع: Object<string, *> مشخصه‌های سفارشی خودرو.
name	نوع: string در قالب «providers/{provider_id}/vehicles/{vehicle_id}». ‫vehicle_id باید شناسه یکتایی باشد.
navigationStatus	نوع: VehicleNavigationStatus وضعیت ناوبری فعلی خودرو.
remainingDistanceMeters	نوع: number مسافت رانندگی باقی‌مانده در بخش مسیر فعلی، به متر.
vehicleState	نوع: VehicleState وضعیت خودرو.
vehicleType	نوع: VehicleType نوع این خودرو.
currentRouteSegmentEndPoint اختیاری	نوع: TripWaypoint optional نقطه‌مسیر جایی که بخش مسیر فعلی به‌پایان می‌رسد.
currentRouteSegmentVersion اختیاری	نوع: Date optional زمانی که بخش مسیر فعلی تنظیم شد.
currentTrips اختیاری	نوع: Array<string> optional فهرست شناسه‌های سفر برای سفرهایی که درحال‌حاضر به این خودرو اختصاص داده شده است.
etaToFirstWaypoint اختیاری	نوع: Date optional زمان تقریبی ورود به اولین ورودی در فیلد نقاط‌مسیر.
latestLocation اختیاری	نوع: VehicleLocationUpdate optional آخرین مکان گزارش‌شده خودرو.
maximumCapacity اختیاری	نوع: number optional تعداد کل مسافرانی که این خودرو می‌تواند حمل کند. راننده در این مقدار درنظر گرفته نشده است.
supportedTripTypes اختیاری	نوع: Array<TripType> optional انواع سفرهایی که این خودرو پشتیبانی می‌کند.
waypoints اختیاری	نوع: Array<TripWaypoint> optional نقطه‌مسیرهای باقی‌مانده اختصاص‌داده‌شده به این «خودرو».
waypointsVersion اختیاری	نوع: Date optional آخرین باری که فیلد نقاط‌مسیر به‌روزرسانی شد.

ثابت‌های VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus ثابت‌ها
کتابخانه "journeySharing"

وضعیت پیمایش فعلی Vehicle.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع VehicleNavigationStatusString تعریف می‌شوند.

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

ثابت‌ها
ARRIVED_AT_DESTINATION	وسیله نقلیه در فاصله تقریباً ۵۰ متری مقصد است.
ENROUTE_TO_DESTINATION	ناوبری گام‌به‌گام دردسترس است و ناوبری برنامه Driver وارد حالت GUIDED_NAV شده است.
NO_GUIDANCE	ناوبری برنامه Driver در حالت FREE_NAV است.
OFF_ROUTE	خودرو از مسیر پیشنهادی خارج شده است.
UNKNOWN_NAVIGATION_STATUS	وضعیت ناوبری نامشخص.

ثابت‌های VehicleState

google.maps.journeySharing.VehicleState ثابت‌ها
کتابخانه "journeySharing"

وضعیت کنونی Vehicle.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع VehicleStateString تعریف می‌شوند.

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

ثابت‌ها
OFFLINE	خودرو سفر جدید نمی‌پذیرد.
ONLINE	خودرو سفرهای جدید را می‌پذیرد.
UNKNOWN_VEHICLE_STATE	وضعیت خودرو نامشخص است.

ثابت‌های VehicleType

google.maps.journeySharing.VehicleType ثابت‌ها
کتابخانه "journeySharing"

نوع Vehicle.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع VehicleTypeString تعریف می‌شوند.

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

ثابت‌ها
AUTO	اتومبیل.
TAXI	هر وسیله نقلیه‌ای که به‌عنوان تاکسی عمل می‌کند (معمولاً دارای مجوز یا تحت نظارت).
TRUCK	خودرویی با ظرفیت ذخیره‌سازی بزرگ.
TWO_WHEELER	موتورسیکلت، موتور گازی، یا وسیله نقلیه دوچرخ دیگر.
UNKNOWN	نوع خودرو نامشخص است.

ثابت‌های TripType

google.maps.journeySharing.TripType ثابت‌ها
کتابخانه "journeySharing"

انواع سفر پشتیبانی‌شده توسط Vehicle.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع TripTypeString تعریف می‌شوند.

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

ثابت‌ها
EXCLUSIVE	سفر مختص یک خودرو است.
SHARED	ممکن است خودرو با سفرهای دیگر مشترک باشد.
UNKNOWN_TRIP_TYPE	نوع سفر نامشخص است.

TripWaypoint میانای

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

نوع TripWaypoint.

مشخصات
distanceMeters اختیاری	نوع: number optional فاصله مسیر بین نقطه‌مسیر قبلی (یا مکان فعلی خودرو، اگر این نقطه‌مسیر اولین نقطه‌مسیر در فهرست نقطه‌مسیرها باشد) تا این نقطه‌مسیر برحسب متر.
durationMillis اختیاری	نوع: number optional مدت سفر بین نقطه‌مسیر قبلی (یا مکان فعلی خودرو، اگر این نقطه‌مسیر اولین نقطه‌مسیر در فهرست نقطه‌مسیرها باشد) تا این نقطه‌مسیر برحسب میلی‌ثانیه.
location اختیاری	نوع: LatLng optional مکان نقطه‌مسیر.
path اختیاری	نوع: Array<LatLng> optional مسیر از ایستگاه قبلی (یا مکان فعلی خودرو، اگر این ایستگاه اولین ایستگاه در فهرست ایستگاه‌ها باشد) به این ایستگاه.
speedReadingIntervals اختیاری	نوع: Array<SpeedReadingInterval> optional فهرست سرعت‌های ترافیک درطول مسیر از نقطه‌مسیر قبلی (یا مکان خودرو) تا نقطه‌مسیر فعلی. هر بازه در فهرست، ترافیک را در یک بخش مجاور در مسیر توصیف می‌کند؛ بازه، نقاط شروع و پایان بخش را ازطریق نمایه‌های آن‌ها تعریف می‌کند. برای جزئیات بیشتر، تعریف SpeedReadingInterval را ببینید.
tripId اختیاری	نوع: string optional سفر مرتبط با این نقطه‌مسیر.
waypointType اختیاری	نوع: WaypointType optional نقشی که این نقطه‌مسیر در این سفر ایفا می‌کند، مانند سوار کردن یا پیاده کردن.

ثابت‌های WaypointType

google.maps.journeySharing.WaypointType ثابت‌ها
کتابخانه "journeySharing"

انواع نقطه‌مسیر پشتیبانی‌شده توسط Vehicle.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع WaypointTypeString تعریف می‌شوند.

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

ثابت‌ها
DROP_OFF_WAYPOINT_TYPE	نقطه‌مسیرهای پیاده کردن مسافران.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE	نقطه‌مسیرهای مقصدهای میانی در سفر چندمقصدی.
PICKUP_WAYPOINT_TYPE	نقطه‌مسیرهای سوار کردن مسافران.
UNKNOWN_WAYPOINT_TYPE	نوع نقطه‌مسیر نامشخص است.

TimeWindow میانای

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

یک دامنه زمانی.

مشخصات
endTime	نوع: Date زمان پایان بازه زمانی (شامل).
startTime	نوع: Date زمان شروع پنجره زمانی (فراگیر).

یادآورهای همیشگی سرعت

google.maps.journeySharing.Speed ثابت‌ها
کتابخانه "journeySharing"

طبقه‌بندی سرعت چندخطی براساس داده‌های ترافیک.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع SpeedString تعریف می‌شوند.

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

ثابت‌ها
NORMAL	سرعت عادی، هیچ کندی‌ای شناسایی نشده است.
SLOW	کاهش سرعت شناسایی شد، اما ترافیک سنگین ایجاد نشد.
TRAFFIC_JAM	ترافیک شناسایی شد.

میانای SpeedReadingInterval

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

نشانگر تراکم ترافیک در بخش مسیر مجاور. این بازه نقاط شروع و پایان بخش را ازطریق شاخص‌های آن‌ها تعریف می‌کند.

مشخصات
endPolylinePointIndex	نوع: number نمایه مبتنی بر صفر نقطه پایانی فاصله در مسیر.
speed	نوع: Speed سرعت ترافیک در این بازه.
startPolylinePointIndex	نوع: number نمایه صفرپایه نقطه شروع بازه در مسیر.