Fleet Engine Entities

رابط وظیفه

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

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

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

رابط TaskInfo

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

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

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

رابط TaskTrackingInfo

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

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

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

رابط سفر

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

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

name
نوع: string
در قالب "provider/{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، یا COMPELED.
type
نوع: string
نوع سفر. مقادیر ممکن UNKNOWN_TRIP_TYPE، SHARED یا EXCLUSIVE هستند.
vehicleId
نوع: string
شناسه وسیله نقلیه ای که این سفر را انجام می دهد.
actualDropOffLocation optional
نوع: LatLngLiteral optional
مکانی که مشتری در آن پیاده شده است.
actualPickupLocation optional
نوع: LatLngLiteral optional
محل تحویل مشتری
dropOffTime optional
نوع: Date optional
زمان تخمینی در آینده که مسافران پیاده خواهند شد، یا زمان واقعی زمانی که مسافران پیاده شدند.
latestVehicleLocationUpdate optional
نوع: VehicleLocationUpdate optional
اطلاعات مربوط به آخرین به‌روزرسانی مکان.
pickupTime optional
نوع: Date optional
زمان تخمینی در آینده که مسافران سوار خواهند شد، یا زمان واقعی زمانی که مسافران سوار شدند.
plannedDropOffLocation optional
نوع: LatLngLiteral optional
مکانی که مشتری نشان می دهد که آنها را ترک خواهند کرد.
plannedPickupLocation optional
نوع: LatLngLiteral optional
مکانی که مشتری نشان می دهد که آنها را تحویل می گیرند.

رابط DeliveryVehicle

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

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

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

رابط DeliveryVehicleStop

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

نوع DeliveryVehicleStop

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

ثابت های DeliveryVehicleStopState

google.maps.journeySharing . DeliveryVehicleStopState ثابت های google.maps.journeySharing . DeliveryVehicleStopState

وضعیت فعلی یک DeliveryVehicleStop .

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

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

رابط VehicleJourneySegment

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

VehicleJourneySegment نوع

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

رابط به روز رسانی مکان خودرو

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

نوع به روز رسانی مکان خودرو

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

رابط وسیله نقلیه

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

نوع وسیله نقلیه.

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

رابط وسیله نقلیه

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

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

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

ثابت های وضعیت ناوبری خودرو

google.maps.journeySharing . VehicleNavigationStatus ثابت های google.maps.journeySharing . VehicleNavigationStatus

وضعیت ناوبری فعلی یک Vehicle .

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

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

ثابت های حالت خودرو

google.maps.journeySharing . VehicleState ثابت های google.maps.journeySharing . VehicleState

وضعیت فعلی یک Vehicle

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

OFFLINE وسیله نقلیه سفرهای جدید را نمی پذیرد.
ONLINE خودرو در حال پذیرش سفرهای جدید است.
UNKNOWN_VEHICLE_STATE وضعیت نامشخص خودرو

ثابت های نوع وسیله نقلیه

google.maps.journeySharing . VehicleType ثابت های google.maps.journeySharing . VehicleType

نوع Vehicle .

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

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

ثابت های TripType

google.maps.journeySharing . TripType ثابت های google.maps.journeySharing . TripType

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

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

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

رابط TripWaypoint

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

نوع TripWaypoint.

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

ثابت های نوع Waypoint

google.maps.journeySharing . WaypointType ثابت های google.maps.journeySharing . WaypointType

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

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

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

رابط TimeWindow

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

یک محدوده زمانی

endTime
نوع: Date
زمان پایان پنجره زمانی (شامل).
startTime
نوع: Date
زمان شروع پنجره زمانی (شامل).

ثابت های سرعت

google.maps.journeySharing . Speed ثابت های google.maps.journeySharing . Speed

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

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

NORMAL سرعت معمولی، هیچ کاهش سرعت تشخیص داده نمی شود.
SLOW کاهش سرعت شناسایی شد، اما ترافیک ایجاد نشد.
TRAFFIC_JAM ترافیک شناسایی شد

رابط SpeedReadingInterval

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

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

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