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
اطلاعات مربوط به بخش‌هایی که برای این تکلیف باقی مانده است.
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 interface

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

نوع TaskInfo، استفاده‌شده توسط DeliveryVehicleStop.
extraDurationMillis optional
نوع:  number optional
زمان اضافه‌ای که برای انجام تکلیف لازم است، برحسب میلی‌ثانیه.
id optional
نوع:  string optional
شناسه تکلیف.
targetTimeWindow optional
نوع:  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 optional
نوع:  Date optional
زمان تخمینی رسیدن به مکان ایستگاه.
estimatedTaskCompletionTime optional
نوع:  Date optional
زمان تکمیل تخمینی «تکلیف».
latestVehicleLocationUpdate optional
نوع:  VehicleLocationUpdate optional
اطلاعات مختص به آخرین به‌روزرسانی مکان.
plannedLocation optional
نوع:  LatLng optional
مکانی که «تکلیف» در آن تکمیل خواهد شد.
remainingDrivingDistanceMeters optional
نوع:  number optional
کل مسافت باقی‌مانده به متر تا VehicleStop موردنظر.
remainingStopCount optional
نوع:  number optional
تعداد توقف‌های باقی‌مانده خودرو تا رسیدن به توقف تکلیف را نشان می‌دهد، ازجمله توقف تکلیف. برای مثال، اگر ایستگاه بعدی خودرو ایستگاه تکلیف باشد، مقدار ۱ خواهد بود.
routePolylinePoints optional
نوع:  Array<LatLng> optional
فهرستی از نقاط که وقتی به هم متصل می‌شوند، چندخطی مسیر موردانتظار خودرو به مکان این تکلیف را تشکیل می‌دهند.
state optional
نوع:  string optional
وضعیت اجرای فعلی «تکلیف».
targetTimeWindow optional
نوع:  TimeWindow optional
بازه زمانی که تکلیف باید در آن تکمیل شود.
taskOutcome optional
نوع:  string optional
نتیجه تلاش برای اجرای «تکلیف».
taskOutcomeTime optional
نوع:  Date optional
زمانی که نتیجه «تکلیف» توسط ارائه‌دهنده تنظیم شده است.

میانای سفر

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

جزئیات سفر برگردانده‌شده توسط Fleet Engine.
name
نوع:  string
در قالب «providers/{provider_id}/trips/{trip_id}». ‫trip_id باید شناسه یکتایی باشد.
passengerCount
نوع:  number
تعداد مسافران این سفر؛ شامل راننده نمی‌شود.
remainingWaypoints
آرایه‌ای از نقطه‌مسیرها که مسیر از مکان فعلی تا نقطه پیاده کردن را نشان می‌دهد.
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 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

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

میانای DeliveryVehicleStop

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

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

ثابت‌های 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

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

میانای VehicleLocationUpdate

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

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

میانای VehicleWaypoint

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

نوع 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

جزئیات خودرویی که Fleet Engine برگردانده است.
attributes
نوع:  Object<string, *>
مشخصه‌های سفارشی خودرو.
name
نوع:  string
در قالب «providers/{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
زمان تقریبی ورود به اولین ورودی در فیلد نقاط‌مسیر.
latestLocation optional
نوع:  VehicleLocationUpdate optional
آخرین مکان گزارش‌شده خودرو.
maximumCapacity optional
نوع:  number optional
تعداد کل مسافرانی که این خودرو می‌تواند حمل کند. راننده در این مقدار درنظر گرفته نشده است.
supportedTripTypes optional
نوع:  Array<TripType> optional
انواع سفرهایی که این خودرو پشتیبانی می‌کند.
waypoints optional
نوع:  Array<TripWaypoint> optional
نقطه‌مسیرهای باقی‌مانده اختصاص‌داده‌شده به این «خودرو».
waypointsVersion optional
نوع:  Date optional
آخرین باری که فیلد نقاط‌مسیر به‌روزرسانی شد.

ثابت‌های VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus یادآور همیشگی

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

با تماس با const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
ARRIVED_AT_DESTINATION وسیله نقلیه در فاصله تقریباً ۵۰ متری مقصد است.
ENROUTE_TO_DESTINATION ناوبری گام‌به‌گام دردسترس است و ناوبری برنامه Driver وارد حالت GUIDED_NAV شده است.
NO_GUIDANCE ناوبری برنامه Driver در حالت FREE_NAV است.
OFF_ROUTE خودرو از مسیر پیشنهادی خارج شده است.
UNKNOWN_NAVIGATION_STATUS وضعیت ناوبری نامشخص.

ثابت‌های VehicleState

google.maps.journeySharing.VehicleState یادآور همیشگی

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

با تماس با const {VehicleState} = await google.maps.importLibrary("journeySharing") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
OFFLINE خودرو سفر جدید نمی‌پذیرد.
ONLINE خودرو سفرهای جدید را می‌پذیرد.
UNKNOWN_VEHICLE_STATE وضعیت خودرو نامشخص است.

ثابت‌های 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 یادآور همیشگی

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

با تماس با const {TripType} = await google.maps.importLibrary("journeySharing") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
EXCLUSIVE سفر مختص یک خودرو است.
SHARED ممکن است خودرو با سفرهای دیگر مشترک باشد.
UNKNOWN_TRIP_TYPE نوع سفر نامشخص است.

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
نقشی که این نقطه‌مسیر در این سفر ایفا می‌کند، مانند سوار کردن یا پیاده کردن.

ثابت‌های 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

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

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

google.maps.journeySharing.Speed یادآور همیشگی

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

با تماس با const {Speed} = await google.maps.importLibrary("journeySharing") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
NORMAL سرعت عادی، هیچ کندی‌ای شناسایی نشده است.
SLOW کاهش سرعت شناسایی شد، اما ترافیک سنگین ایجاد نشد.
TRAFFIC_JAM ترافیک شناسایی شد.

میانای SpeedReadingInterval

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

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