Package maps.fleetengine.v1

شاخص

• TripService (رابط)
• VehicleService (رابط)
• BatteryInfo (پیام)
• BatteryStatus (عدد)
• BillingPlatformIdentifier (enum)
• ConsumableTrafficPolyline (پیام)
• CreateTripRequest (پیام)
• CreateVehicleRequest (پیام)
• DeviceSettings (پیام)
• GetTripRequest (پیام)
• GetVehicleRequest (پیام)
• LicensePlate (پیام)
• ListVehiclesRequest (پیام)
• ListVehiclesResponse (پیام)
• LocationPowerSaveMode (enum)
• LocationSensor (تعدادی)
• NavigationStatus (enum)
• PolylineFormatType (enum)
• PowerSource (enum)
• ReportBillableTripRequest (پیام)
• ReportBillableTripRequest.SolutionType (enum)
• RequestHeader (پیام)
• RequestHeader.Platform (enum)
• RequestHeader.SdkType (enum)
• SearchTripsRequest (پیام)
• SearchTripsResponse (پیام)
• SearchVehiclesRequest (پیام)
• SearchVehiclesRequest.CurrentTripsPresent (enum)
• SearchVehiclesRequest.VehicleMatchOrder (enum)
• SearchVehiclesResponse (پیام)
• SpeedReadingInterval (پیام)
• SpeedReadingInterval.Speed ​​(enum)
• StopLocation (پیام)
• TerminalLocation (پیام)
• TerminalPointId (پیام) (منسوخ شده)
• TrafficPolylineData (پیام)
• Trip (پیام)
• TripStatus (enum)
• TripType (enum)
• TripView (enum)
• TripWaypoint (پیام)
• UpdateTripRequest (پیام)
• UpdateVehicleAttributesRequest (پیام)
• UpdateVehicleAttributesResponse (پیام)
• UpdateVehicleRequest (پیام)
• Vehicle (پیام)
• Vehicle.VehicleType (پیام)
• Vehicle.VehicleType.Category (تعدادی)
• VehicleAttribute (پیام)
• VehicleAttributeList (پیام)
• VehicleLocation (پیام)
• VehicleMatch (پیام)
• VehicleMatch.VehicleMatchType (enum)
• VehicleState (تعدادی)
• VisualTrafficReportPolylineRendering (پیام)
• VisualTrafficReportPolylineRendering.RoadStretch (پیام)
• VisualTrafficReportPolylineRendering.RoadStretch.Style (enum)
• Waypoint (پیام)
• WaypointType (enum)

تریپ سرویس

خدمات مدیریت سفر.

CreateTrip
rpc CreateTrip( CreateTripRequest ) returns ( Trip ) یک سفر در Fleet Engine ایجاد می کند و سفر جدید را برمی گرداند.

GetTrip
rpc GetTrip( GetTripRequest ) returns ( Trip ) در مورد یک سفر اطلاعات کسب کنید.

ReportBillableTrip
rpc ReportBillableTrip( ReportBillableTripRequest ) returns ( Empty ) گزارش استفاده از سفر قابل پرداخت

SearchTrips
rpc SearchTrips( SearchTripsRequest ) returns ( SearchTripsResponse ) تمام سفرها را برای یک وسیله نقلیه خاص دریافت کنید.

UpdateTrip
rpc UpdateTrip( UpdateTripRequest ) returns ( Trip ) داده های سفر را به روز می کند.

سرویس خودرو

خدمات مدیریت خودرو.

Create Vehicle

rpc CreateVehicle( CreateVehicleRequest ) returns ( Vehicle ) یک وسیله نقلیه جدید مرتبط با یک ارائه‌دهنده سهم یا تحویل بر اساس تقاضا را نشان می‌دهد. هر Vehicle باید یک شناسه وسیله نقلیه منحصر به فرد داشته باشد. هنگام ایجاد یک Vehicle فیلدهای Vehicle مورد نیاز است: vehicleState supportedTripTypes maximumCapacity vehicleType هنگام ایجاد یک Vehicle فیلدهای Vehicle زیر نادیده گرفته می شوند: name currentTrips availableCapacity current_route_segment current_route_segment_end_point current_route_segment_version current_route_segment_traffic route waypoints waypoints_version remaining_distance_meters remaining_time_seconds eta_to_next_waypoint navigation_status تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند.

GetVehicle
rpc GetVehicle( GetVehicleRequest ) returns ( Vehicle ) یک وسیله نقلیه را از موتور ناوگان برمی‌گرداند.

ListVehicles
rpc ListVehicles( ListVehiclesRequest ) returns ( ListVehiclesResponse ) فهرست صفحه بندی شده ای از وسایل نقلیه مرتبط با ارائه دهنده ای را برمی گرداند که با گزینه های درخواست مطابقت دارند.

جستجوی وسایل نقلیه
rpc SearchVehicles( SearchVehiclesRequest ) returns ( SearchVehiclesResponse ) فهرستی از وسایل نقلیه را برمی‌گرداند که با گزینه‌های درخواست مطابقت دارند.

Update Vehicle

rpc UpdateVehicle( UpdateVehicleRequest ) returns ( Vehicle ) داده های به روز شده خودرو را در Fleet Engine می نویسد. هنگام به‌روزرسانی یک Vehicle ، فیلدهای زیر نمی‌توانند به‌روزرسانی شوند، زیرا توسط سرور مدیریت می‌شوند: currentTrips availableCapacity current_route_segment_version waypoints_version name خودرو نیز نمی تواند به روز شود. اگر فیلد attributes به روز شود، تمام ویژگی های خودرو با ویژگی های ارائه شده در درخواست جایگزین می شود. اگر می خواهید فقط برخی از ویژگی ها را به روز کنید، به روش UpdateVehicleAttributes مراجعه کنید. به همین ترتیب، فیلد waypoints می‌توان به‌روزرسانی کرد، اما باید شامل تمام ایستگاه‌های بین راه در حال حاضر در وسیله نقلیه باشد، و هیچ نقطه‌ای دیگر را در بر نگیرد.

UpdateVehicleAttributes
rpc UpdateVehicleAttributes( UpdateVehicleAttributesRequest ) returns ( UpdateVehicleAttributesResponse ) تا حدی ویژگی های خودرو را به روز می کند. فقط ویژگی های ذکر شده در درخواست به روز می شوند، سایر ویژگی ها تغییر نخواهند کرد. توجه: این در UpdateVehicle متفاوت است، جایی که کل فیلد attributes با یکی در UpdateVehicleRequest جایگزین می شود، ویژگی هایی که در درخواست نیستند حذف می شوند.

BatteryInfo

اطلاعاتی در مورد باتری دستگاه

فیلدها
battery_ status	BatteryStatus وضعیت باتری، پر بودن یا شارژ شدن و غیره
power_ source	PowerSource وضعیت منبع تغذیه باتری
battery_ percentage	float درصد باتری فعلی [0-100].

وضعیت باتری

وضعیت باتری، پر بودن یا شارژ شدن و غیره

Enums
UNKNOWN_BATTERY_STATUS	وضعیت باتری نامشخص است.
BATTERY_STATUS_CHARGING	باتری در حال شارژ شدن است.
BATTERY_STATUS_DISCHARGING	باتری در حال تخلیه است.
BATTERY_STATUS_FULL	باتری پر است.
BATTERY_STATUS_NOT_CHARGING	باتری شارژ نمی شود.
BATTERY_STATUS_POWER_LOW	شارژ باتری کم است.

BillingPlatformIdentifier

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

Enums
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED	پیش فرض برای پلتفرم های نامشخص استفاده می شود.
SERVER	پلتفرم یک سرور مشتری است.
WEB	پلتفرم یک مرورگر وب است.
ANDROID	این پلتفرم یک دستگاه موبایل اندرویدی است.
IOS	این پلتفرم یک دستگاه موبایل IOS است.
OTHERS	پلتفرم های دیگری که در این شمارش فهرست نشده اند.

ConsumableTrafficPolyline

تراکم ترافیک در مسیر یک وسیله نقلیه.

فیلدها
speed_ reading_ interval[]	SpeedReadingInterval سرعت ترافیک در طول مسیر از ایستگاه قبلی تا ایستگاه فعلی.
encoded_ path_ to_ waypoint	string مسیری که راننده از ایستگاه قبلی تا ایستگاه فعلی طی می کند. این مسیر دارای نشانه‌هایی در خود است، بنابراین مشتریان می‌توانند نشانگرهای ترافیکی را در طول مسیر نشان دهند (به speed_reading_interval مراجعه کنید). رمزگشایی هنوز پشتیبانی نمی شود.

CreateTripRequest

پیام درخواست CreateTrip.

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
parent	string مورد نیاز. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
trip_ id	string مورد نیاز. شناسه منحصر به فرد سفر مشروط به محدودیت های زیر: باید یک رشته یونیکد معتبر باشد. حداکثر به طول 64 کاراکتر محدود شده است. طبق فرم C عادی سازی یونیکد نرمال شده است. ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
trip	Trip مورد نیاز. نهاد سفر برای ایجاد. هنگام ایجاد یک سفر، فیلدهای زیر مورد نیاز است: trip_type pickup_point در صورت ارائه فیلدهای زیر استفاده می شود: number_of_passengers vehicle_id dropoff_point intermediate_destinations vehicle_waypoints همه فیلدهای سفر دیگر نادیده گرفته می شوند. به عنوان مثال، همه سفرها با یک trip_status NEW شروع می‌شوند، حتی اگر در درخواست ایجاد یک trip_status CANCELED عبور کنید. فقط سفرهای EXCLUSIVE از intermediate_destinations پشتیبانی می‌کنند. هنگامی که vehicle_id برای یک سفر مشترک تنظیم شده است، باید لیست Trip.vehicle_waypoints را ارائه کنید تا ترتیب نقاط بین راه برای وسیله نقلیه را مشخص کنید، در غیر این صورت ترتیب ایستگاه های بین راهی نامشخص خواهد بود. هنگامی که Trip.vehicle_waypoints مشخص می‌کنید، فهرست باید شامل تمام ایستگاه‌های باقی‌مانده از سفرهای وسیله نقلیه باشد، بدون هیچ نقطه‌ای اضافی. شما باید این نقاط بین راه را طوری سفارش دهید که برای یک سفر معین، نقطه تحویل قبل از مقصدهای میانی باشد و همه مقصدهای میانی قبل از نقطه تحویل قرار گیرند. ایستگاه های بین راهی یک سفر EXCLUSIVE نباید با هیچ سفر دیگری تداخل داشته باشد. از فیلدهای trip_id ، waypoint_type و location استفاده می‌شود و تمام فیلدهای دیگر TripWaypoint در vehicle_waypoints نادیده گرفته می‌شوند.

CreateVehicleRequest

پیام درخواست CreateVehicle .

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
parent	string مورد نیاز. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
vehicle_ id	string مورد نیاز. شناسه منحصر به فرد خودرو مشروط به محدودیت های زیر: باید یک رشته یونیکد معتبر باشد. حداکثر به طول 64 کاراکتر محدود شده است. طبق فرم C عادی سازی یونیکد نرمال شده است. ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
vehicle	Vehicle مورد نیاز. نهاد وسیله نقلیه برای ایجاد. هنگام ایجاد یک وسیله نقلیه، فیلدهای زیر مورد نیاز است: vehicleState supportedTripTypes maximumCapacity vehicleType هنگام ایجاد یک وسیله نقلیه، فیلدهای زیر نادیده گرفته می شوند: name currentTrips availableCapacity current_route_segment current_route_segment_end_point current_route_segment_version current_route_segment_traffic route waypoints waypoints_version remaining_distance_meters remaining_time_seconds eta_to_next_waypoint navigation_status تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند.

تنظیمات دستگاه

اطلاعات مربوط به تنظیمات مختلف در دستگاه تلفن همراه.

فیلدها
location_ power_ save_ mode	LocationPowerSaveMode وقتی «بهینه‌سازی باتری» روشن است، ویژگی‌های مکان چگونه تنظیم می‌شوند تا در دستگاه رفتار کنند.
is_ power_ save_ mode	bool اینکه آیا دستگاه در حال حاضر در حالت صرفه جویی در مصرف انرژی است یا خیر.
is_ interactive	bool اینکه آیا دستگاه در حالت تعاملی است.
battery_ info	BatteryInfo اطلاعاتی در مورد وضعیت باتری

GetTripRequest

پیام درخواست GetTrip.

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
name	string مورد نیاز. باید در قالب providers/{provider}/trips/{trip} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
view	TripView زیر مجموعه فیلدهای Trip که باید برگردانده شوند و تفسیر آنها.
current_ route_ segment_ version	Timestamp نشان‌دهنده حداقل مهر زمانی (انحصاری) است که داده‌های Trip.route یا Trip.current_route_segment برای آن بازیابی می‌شوند. اگر داده‌های مسیر از این مهر زمانی تغییری نکرده باشند، فیلد مسیر در پاسخ تنظیم نمی‌شود. اگر حداقل مشخص نشده باشد، داده های مسیر همیشه بازیابی می شوند.
remaining_ waypoints_ version	Timestamp حداقل مهر زمانی (انحصاری) که Trip.remaining_waypoints برای آن بازیابی شده است را نشان می دهد. اگر از این مُهر زمانی تغییری نکرده باشند، remaining_waypoints در پاسخ تنظیم نمی شوند. اگر این فیلد مشخص نشده باشد، remaining_waypoints همیشه بازیابی می شود.
route_ format_ type	PolylineFormatType قالب مسیر فعلی برگشتی، LAT_LNG_LIST_TYPE (در Trip.route )، یا ENCODED_POLYLINE_TYPE (در Trip.current_route_segment ). پیش فرض LAT_LNG_LIST_TYPE است.
current_ route_ segment_ traffic_ version	Timestamp حداقل مهر زمانی (انحصاری) که Trip.current_route_segment_traffic برای آن بازیابی شده است را نشان می دهد. اگر داده‌های ترافیک از این مُهر زمانی تغییر نکرده باشد، فیلد current_route_segment_traffic در پاسخ تنظیم نشده است. اگر حداقل مشخص نشده باشد، داده های ترافیک همیشه بازیابی می شوند. توجه داشته باشید که ترافیک فقط برای مشتریان On-Demand Rides و Deliveries Solution در دسترس است.
remaining_ waypoints_ route_ version	Timestamp حداقل مهر زمانی (انحصاری) را نشان می‌دهد که داده‌های Trip.remaining_waypoints.traffic_to_waypoint و Trip.remaining_waypoints.path_to_waypoint برای آن بازیابی شده‌اند. اگر داده‌ها از این مهر زمانی تغییر نکرده باشند، فیلدهای بالا در پاسخ تنظیم نمی‌شوند. اگر remaining_waypoints_route_version نامشخص باشد، ترافیک و مسیر همیشه بازیابی می‌شوند.

GetVehicleRequest

پیام درخواست GetVehicle .

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
name	string مورد نیاز. باید در قالب providers/{provider}/vehicles/{vehicle} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
current_ route_ segment_ version	Timestamp حداقل مهر زمانی (انحصاری) که Vehicle.current_route_segment برای آن بازیابی شده است را نشان می دهد. اگر مسیر از این مهر زمانی تغییر نکرده باشد، فیلد current_route_segment در پاسخ تنظیم نشده است. اگر حداقل مشخص نشده باشد، قسمت current_route_segment همیشه بازیابی می شود.
waypoints_ version	Timestamp حداقل مهر زمانی (انحصاری) که داده‌های Vehicle.waypoints برای آن بازیابی شده است را نشان می‌دهد. اگر نقاط راه از زمان این مهر زمانی تغییری نکرده باشند، داده‌های vehicle.waypoints در پاسخ تنظیم نمی‌شوند. اگر این فیلد مشخص نشده باشد، vehicle.waypoints همیشه بازیابی می شود.

پلاک مجوز

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

فیلدها
country_ code	string مورد نیاز. کد کشور/منطقه CLDR. به عنوان مثال، US برای ایالات متحده، یا IN برای هند.
last_ character	string آخرین رقم پلاک یا "-1" برای نشان دادن هیچ عددی در پلاک وجود ندارد. "ABC 1234" -> "4" "AB 123 CD" -> "3" "ABCDEF" -> "-1"

ListVehiclesRequest

پیام درخواست ListVehicles .

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
parent	string مورد نیاز. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
page_ size	int32 حداکثر تعداد وسایل نقلیه برای بازگشت. مقدار پیش فرض: 100.
page_ token	string مقدار next_page_token که با تماس قبلی با ListVehicles ارائه شده است تا بتوانید از طریق گروه‌های وسایل نقلیه صفحه‌بندی کنید. اگر معیار فیلتر درخواست با معیار فیلتر تماس قبلی با ListVehicles یکسان نباشد، مقدار تعریف نشده است.
minimum_ capacity	Int32Value حداقل ظرفیت مورد نیاز وسیله نقلیه را مشخص می کند. تمام وسایل نقلیه برگشتی دارای maximum_capacity بزرگتر یا مساوی با این مقدار خواهند بود. اگر تنظیم شود، باید بزرگتر یا مساوی 0 باشد.
trip_ types[]	TripType پاسخ به وسایل نقلیه ای را که حداقل یکی از انواع سفرهای مشخص شده را پشتیبانی می کنند، محدود می کند.
maximum_ staleness	Duration پاسخ به خودروهایی را که در مدت زمان مشخص شده به‌روزرسانی‌های مکان را به Fleet Engine ارسال کرده‌اند، محدود می‌کند. وسایل نقلیه ثابتی که هنوز مکان خود را مخابره می کنند کهنه در نظر گرفته نمی شوند. در صورت وجود، باید مدت زمان مثبت معتبر باشد.
vehicle_ type_ categories[]	Category مورد نیاز. پاسخ به وسایل نقلیه با یکی از دسته بندی های نوع مشخص شده را محدود می کند. UNKNOWN مجاز نیست.
required_ attributes[]	string تماس گیرندگان می توانند عملیات منطقی پیچیده ای را با استفاده از هر ترکیبی از فیلدهای required_attributes ، required_one_of_attributes ، و required_one_of_attribute_sets تشکیل دهند. required_attributes یک لیست است. required_one_of_attributes از پیامی استفاده می کند که لیستی از لیست ها را امکان پذیر می کند. در ترکیب، دو فیلد اجازه ترکیب این عبارت را می دهند: (required_attributes[0] AND required_attributes[1] AND ...) AND (required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR ...) AND (required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR ...) پاسخ به وسایل نقلیه با ویژگی های مشخص شده را محدود می کند. این فیلد یک عملیات ربط/AND است. حداکثر 50 مورد_ویژگی مجاز است. این با حداکثر تعداد مشخصه های مجاز در یک وسیله نقلیه مطابقت دارد. هر رشته تکرار شده باید با فرمت "key:value" باشد.
required_ one_ of_ attributes[]	string پاسخ به وسایل نقلیه با حداقل یکی از ویژگی های مشخص شده در هر VehicleAttributeList را محدود می کند. در هر فهرست، یک وسیله نقلیه باید حداقل با یکی از ویژگی ها مطابقت داشته باشد. این فیلد یک عملیات تفکیک/OR فراگیر در هر VehicleAttributeList و یک عملیات ربط/AND در مجموعه VehicleAttributeList است. هر رشته تکرار شده باید با فرمت "key1:value1|key2:value2|key3:value3" باشد.
required_ one_ of_ attribute_ sets[]	string required_one_of_attribute_sets قابلیت های بیشتری را ارائه می دهد. مشابه required_one_of_attributes ، required_one_of_attribute_sets از پیامی استفاده می‌کند که فهرستی از لیست‌ها را مجاز می‌کند و عباراتی مانند این را مجاز می‌سازد: (required_attributes[0] AND required_attributes[1] AND ...) AND ( (required_one_of_attribute_sets[0][0] AND required_one_of_attribute_sets[0][1] AND ...) OR (required_one_of_attribute_sets[1][0] AND required_one_of_attribute_sets[1][1] AND ...) ) پاسخ را به وسایل نقلیه ای محدود می کند که با تمام ویژگی های یک VehicleAttributeList مطابقت دارند. در هر لیست، یک وسیله نقلیه باید با تمام ویژگی ها مطابقت داشته باشد. این فیلد یک عملیات ربط/و در هر VehicleAttributeList و عملیات تفکیک/OR فراگیر در مجموعه VehicleAttributeList است. هر رشته تکرار شده باید با فرمت "key1:value1|key2:value2|key3:value3" باشد.
vehicle_ state	VehicleState پاسخ را به خودروهایی که دارای این وضعیت خودرو هستند محدود می کند.
on_ trip_ only	bool فقط وسایل نقلیه با سفر(های) فعلی را برگردانید.
filter	string اختیاری. یک درخواست فیلتر برای اعمال در هنگام فهرست کردن وسایل نقلیه. برای نمونه هایی از نحو فیلتر http://aip.dev/160 را ببینید. این فیلد به‌منظور جایگزینی فیلدهای required_attributes ، required_one_of_attributes و required_one_of_attributes_sets طراحی شده است. اگر یک مقدار غیر خالی در اینجا مشخص شده باشد، فیلدهای زیر باید خالی باشند: required_attributes ، required_one_of_attributes ، و required_one_of_attributes_sets . این فیلتر به‌عنوان یک AND با محدودیت‌های دیگر، مانند vehicle_state یا on_trip_only عمل می‌کند. توجه داشته باشید که تنها جستارهای پشتیبانی شده مربوط به ویژگی های وسیله نقلیه هستند (به عنوان مثال، attributes.<key> = <value> یا attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). حداکثر تعداد محدودیت های مجاز در یک جستار فیلتر 50 است. همچنین، تمام ویژگی ها به عنوان رشته ذخیره می شوند، بنابراین تنها مقایسه های پشتیبانی شده در برابر ویژگی ها، مقایسه رشته ها هستند. به منظور مقایسه با مقادیر یا مقادیر بولی، مقادیر باید به صراحت نقل قول شوند تا به عنوان رشته در نظر گرفته شوند (به عنوان مثال، attributes.<key> = "10" یا attributes.<key> = "true" ).
viewport	Viewport اختیاری. فیلتری که وسایل نقلیه بازگشتی را محدود به خودروهایی می‌کند که آخرین مکان شناخته‌شده‌شان در ناحیه مستطیلی تعریف‌شده توسط viewport بوده است.

ListVehiclesResponse

پیام پاسخ ListVehicles .

فیلدها
vehicles[]	Vehicle وسایل نقلیه مطابق با معیارهای موجود در درخواست حداکثر تعداد خودروهای برگشتی با فیلد page_size در درخواست تعیین می شود.
next_ page_ token	string توکن برای بازیابی صفحه بعدی وسایل نقلیه، یا اگر خودروهای دیگری وجود نداشتند که معیارهای درخواست را برآورده کنند خالی کنید.
total_ size	int64 مورد نیاز. تعداد کل وسایل نقلیه مطابق با معیارهای درخواست در تمام صفحات.

LocationPowerSaveMode

وقتی ویژگی «بهینه‌سازی باتری» دستگاه‌ها روشن است، ویژگی‌های مکان چگونه پیکربندی می‌شوند تا در دستگاه تلفن همراه رفتار کنند. ( https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode() )

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE	LocationPowerSaveMode تعریف نشده
LOCATION_MODE_NO_CHANGE	یا ارائه دهندگان موقعیت مکانی نباید تحت تأثیر صرفه جویی در باتری قرار گیرند، یا ذخیره باتری خاموش است.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF	هنگامی که بهینه‌ساز باتری روشن است و دستگاه غیرتعاملی است، ارائه‌دهنده موقعیت مکانی مبتنی بر GPS باید غیرفعال شود.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF	وقتی بهینه‌ساز باتری روشن است و دستگاه غیرتعاملی است، همه ارائه‌دهندگان موقعیت مکانی باید غیرفعال شوند.
LOCATION_MODE_FOREGROUND_ONLY	همه ارائه دهندگان موقعیت مکانی در دسترس خواهند بود، اما اصلاحات مکان فقط باید برای برنامه های پیش زمینه ارائه شود.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF	موقعیت مکانی خاموش نخواهد شد، اما LocationManager تمام درخواست‌های ارائه‌دهندگان را هنگامی که دستگاه غیرتعاملی باشد، کنترل می‌کند.

سنسور مکان

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

Enums
UNKNOWN_SENSOR	سنسور نامشخص یا ناشناخته است.
GPS	GPS یا کمکی GPS.
NETWORK	GPS کمکی، شناسه برج سلولی، یا نقطه دسترسی WiFi.
PASSIVE	شناسه برج سلولی یا نقطه دسترسی WiFi.
ROAD_SNAPPED_LOCATION_PROVIDER	مکانی که توسط دستگاه تلفن همراه به عنوان محتمل ترین موقعیت جاده تعیین می شود.
CUSTOMER_SUPPLIED_LOCATION	مکان ارائه شده توسط مشتری از یک منبع مستقل. به طور معمول، این مقدار برای مکانی استفاده می‌شود که از منابعی غیر از دستگاه تلفن همراهی که Driver SDK را اجرا می‌کند، ارائه می‌شود. اگر منبع اصلی با یکی از مقادیر enum دیگر توصیف شده است، از آن مقدار استفاده کنید. مکان‌هایی که CUSTOMER_SUPPLIED_LOCATION علامت‌گذاری شده‌اند معمولاً از طریق last_location.supplemental_location_sensor یک وسیله نقلیه ارائه می‌شوند.
FLEET_ENGINE_LOCATION	مکانی که توسط Fleet Engine بر اساس سیگنال های موجود محاسبه می شود. فقط خروجی اگر این مقدار در یک درخواست دریافت شود رد می شود.
FUSED_LOCATION_PROVIDER	ارائه دهنده مکان Fused Android.
CORE_LOCATION	ارائه دهنده مکان در سیستم عامل های اپل.

وضعیت ناوبری

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

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

PolylineFormatType

نوع قالب چند خطی.

Enums
UNKNOWN_FORMAT_TYPE	قالب نامشخص یا ناشناخته است.
LAT_LNG_LIST_TYPE	فهرستی از google.type.LatLng .
ENCODED_POLYLINE_TYPE	یک چند خط کدگذاری شده با یک الگوریتم فشرده سازی چند خطی. رمزگشایی هنوز پشتیبانی نمی شود.

منبع تغذیه

نوع شارژر مورد استفاده برای شارژ باتری

Enums
UNKNOWN_POWER_SOURCE	منبع تغذیه ناشناخته
POWER_SOURCE_AC	منبع تغذیه یک شارژر AC است.
POWER_SOURCE_USB	منبع تغذیه یک پورت USB است.
POWER_SOURCE_WIRELESS	منبع تغذیه بی سیم است.
POWER_SOURCE_UNPLUGGED	باتری قطع شده است.

ReportBillableTripRequest

پیام درخواست ReportBillableTrip.

فیلدها
name	string مورد نیاز. باید در قالب providers/{provider}/billableTrips/{billable_trip} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
country_ code	string مورد نیاز. کد کشور دو حرفی کشور محل سفر. قیمت با توجه به کد کشور تعریف می شود.
platform	BillingPlatformIdentifier بستری که درخواست بر اساس آن صادر شده است.
related_ ids[]	string شناسه هایی که مستقیماً با سفر گزارش شده مرتبط هستند. اینها معمولاً شناسه‌هایی (مثلاً شناسه‌های جلسه) مربوط به عملیات پیش‌رزرو هستند که قبل از در دسترس بودن شناسه سفر انجام شده‌اند. تعداد related_ids به 50 عدد محدود شده است.
solution_ type	SolutionType نوع راه حل محصول GMP (به عنوان مثال، ON_DEMAND_RIDESHARING_AND_DELIVERIES ) که برای سفر گزارش شده استفاده شده است.

نوع راه حل

انتخابگر برای انواع راه حل های مختلف یک سفر گزارش شده.

Enums
SOLUTION_TYPE_UNSPECIFIED	مقدار پیش فرض برای سازگاری با عقب، API به طور پیش فرض از ON_DEMAND_RIDESHARING_AND_DELIVERIES استفاده می کند که اولین نوع راه حل پشتیبانی شده است.
ON_DEMAND_RIDESHARING_AND_DELIVERIES	راه حل این است که بر حسب تقاضا سفری به اشتراک گذاشته شود.

RequestHeader

یک RequestHeader حاوی فیلدهای مشترک برای تمام درخواست‌های Fleet Engine RPC است.

فیلدها
language_ code	string کد زبان BCP-47، مانند en-US یا sr-Latn. برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. اگر هیچ یک مشخص نشده باشد، پاسخ ممکن است به هر زبانی باشد و در صورت وجود چنین نامی، ترجیحاً انگلیسی باشد. مثال مقدار فیلد: en-US .
region_ code	string مورد نیاز. کد منطقه CLDR منطقه ای که درخواست از آنجا منشاء می گیرد. مثال مقدار فیلد: US .
sdk_ version	string نسخه SDK تماس، در صورت وجود. قالب نسخه "major.minor.patch" است، به عنوان مثال: 1.1.2 .
os_ version	string نسخه سیستم عاملی که SDK فراخوانی روی آن اجرا می شود. نمونه های مقدار فیلد: 4.4.1 ، 12.1 .
device_ model	string مدل دستگاهی که SDK فراخوانی روی آن اجرا می‌شود. نمونه های مقدار فیلد: iPhone12,1 , SM-G920F .
sdk_ type	SdkType نوع SDK ارسال درخواست.
maps_ sdk_ version	string نسخه MapSDK که در صورت وجود، SDK فراخوانی به آن بستگی دارد. قالب نسخه "major.minor.patch" است، به عنوان مثال: 5.2.1 .
nav_ sdk_ version	string نسخه NavSDK که در صورت وجود، SDK فراخوانی به آن بستگی دارد. قالب نسخه "major.minor.patch" است، به عنوان مثال: 2.1.0 .
platform	Platform پلتفرم SDK فراخوانی.
manufacturer	string سازنده دستگاه Android از SDK تماس گیرنده، فقط برای SDK های Android قابل اجرا است. مثال مقدار فیلد: Samsung .
android_ api_ level	int32 سطح Android API SDK تماس، فقط برای Android SDK قابل اجرا است. مثال مقدار فیلد: 23 .
trace_ id	string شناسه اختیاری که می تواند برای اهداف ورود به سیستم به منظور شناسایی درخواست ارائه شود.

پلت فرم

پلت فرم فراخوانی SDK.

Enums
PLATFORM_UNSPECIFIED	مقدار پیش فرض اگر پلتفرم حذف شود از این مقدار استفاده می شود.
ANDROID	درخواست از اندروید می آید.
IOS	درخواست از iOS می آید.
WEB	درخواست از وب می آید.

SdkType

انواع احتمالی SDK

Enums
SDK_TYPE_UNSPECIFIED	مقدار پیش فرض اگر sdk_type حذف شده باشد از این مقدار استفاده می شود.
CONSUMER	SDK فراخوانی Consumer است.
DRIVER	SDK فراخوانی Driver است.
JAVASCRIPT	SDK فراخوانی جاوا اسکریپت است.

SearchTripsRequest

پیام درخواست SearchTrips.

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
parent	string مورد نیاز. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
vehicle_ id	string وسیله نقلیه مرتبط با سفرهای موجود در درخواست. اگر مشخص نشده باشد، سفرهای برگشتی شامل موارد زیر نیست: current_route_segment remaining_waypoints remaining_distance_meters eta_to_first_waypoint
active_ trips_ only	bool اگر روی true تنظیم شود، پاسخ شامل سفرهایی می شود که بر مسیر راننده تأثیر می گذارد.
page_ size	int32 اگر تنظیم نشود، سرور تعداد نتایجی را که باید بازگردانده شود، تعیین می کند.
page_ token	string این را روی مقداری تنظیم کنید که قبلاً در SearchTripsResponse برگردانده شده است تا نتایج قبلی را ادامه دهید.
minimum_ staleness	Duration اگر مشخص شده باشد، سفرهایی را که بعد از زمان به‌روزرسانی نشده‌اند را برمی‌گرداند (current - minimum_staleness) .

SearchTripsResponse

پیام پاسخ SearchTrips.

فیلدها
trips[]	Trip لیست سفرها برای وسیله نقلیه درخواستی.
next_ page_ token	string این نشانه را در SearchTripsRequest به صفحه نتایج فهرست ارسال کنید. API در هر تماس فهرست سفر را برمی‌گرداند و زمانی که نتیجه دیگری باقی نماند، فهرست سفر خالی است.

Search Vehicles Request

پیام درخواست SearchVehicles .

فیلدها
header	RequestHeader هدر درخواست استاندارد Fleet Engine.
parent	string مورد نیاز. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.
pickup_ point	TerminalLocation مورد نیاز. نقطه تحویل برای جستجو در نزدیکی.
dropoff_ point	TerminalLocation محل خروج مورد نظر مشتری اگر trip_types حاوی TripType.SHARED باشد، فیلد مورد نیاز است.
pickup_ radius_ meters	int32 مورد نیاز. شعاع جستجوی وسیله نقلیه را در اطراف نقطه وانت تعریف می کند. فقط وسایل نقلیه در شعاع جستجو بازگردانده خواهند شد. مقدار باید بین 400 تا 10000 متر (شامل) باشد.
count	int32 مورد نیاز. حداکثر تعداد وسایل نقلیه برای بازگشت را مشخص می کند. مقدار باید بین 1 تا 50 باشد (شامل).
minimum_ capacity	int32 مورد نیاز. تعداد مسافرانی که برای یک سفر در نظر گرفته شده اند را مشخص می کند. مقدار باید بزرگتر یا مساوی یک باشد. راننده در مقدار ظرفیت در نظر گرفته نمی شود.
trip_ types[]	TripType مورد نیاز. نشان دهنده نوع سفر پیشنهادی است. باید دقیقاً یک نوع را شامل شود. UNKNOWN_TRIP_TYPE مجاز نیست. جستجو را فقط به وسایل نقلیه‌ای محدود می‌کند که می‌توانند آن نوع سفر را پشتیبانی کنند.
maximum_ staleness	Duration جستجو را فقط به وسایل نقلیه‌ای محدود می‌کند که در مدت زمان مشخص شده به‌روزرسانی‌های مکان را به Fleet Engine ارسال کرده‌اند. وسایل نقلیه ثابتی که هنوز مکان خود را مخابره می کنند کهنه در نظر گرفته نمی شوند. اگر این فیلد تنظیم نشده باشد، سرور از پنج دقیقه به عنوان مقدار پیش فرض استفاده می کند.
vehicle_ types[]	VehicleType مورد نیاز. جستجو را به خودروهایی با یکی از انواع مشخص شده محدود می کند. حداقل یک نوع وسیله نقلیه باید مشخص شود. انواع خودرو با دسته UNKNOWN مجاز نیستند.
required_ attributes[]	VehicleAttribute تماس گیرندگان می توانند عملیات منطقی پیچیده ای را با استفاده از هر ترکیبی از فیلدهای required_attributes ، required_one_of_attributes ، و required_one_of_attribute_sets تشکیل دهند. required_attributes یک لیست است. required_one_of_attributes از پیامی استفاده می کند که لیستی از لیست ها را امکان پذیر می کند. در ترکیب، دو فیلد اجازه ترکیب این عبارت را می دهند: (required_attributes[0] AND required_attributes[1] AND ...) AND (required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR ...) AND (required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR ...) جستجو را فقط به خودروهایی با ویژگی‌های مشخص شده محدود می‌کند. این فیلد یک عملیات ربط/AND است. حداکثر 50 مورد_ویژگی مجاز است. این با حداکثر تعداد مشخصه های مجاز در یک وسیله نقلیه مطابقت دارد.
required_ one_ of_ attributes[]	VehicleAttributeList جستجو را فقط به آن دسته از وسایل نقلیه با حداقل یکی از ویژگی های مشخص شده در هر VehicleAttributeList محدود می کند. در هر فهرست، یک وسیله نقلیه باید حداقل با یکی از ویژگی ها مطابقت داشته باشد. این فیلد یک عملیات تفکیک/OR فراگیر در هر VehicleAttributeList و یک عملیات ربط/AND در مجموعه VehicleAttributeList است.
required_ one_ of_ attribute_ sets[]	VehicleAttributeList required_one_of_attribute_sets قابلیت های بیشتری را ارائه می دهد. مشابه required_one_of_attributes ، required_one_of_attribute_sets از پیامی استفاده می‌کند که فهرستی از لیست‌ها را مجاز می‌کند و عباراتی مانند این را مجاز می‌سازد: (required_attributes[0] AND required_attributes[1] AND ...) AND ( (required_one_of_attribute_sets[0][0] AND required_one_of_attribute_sets[0][1] AND ...) OR (required_one_of_attribute_sets[1][0] AND required_one_of_attribute_sets[1][1] AND ...) ) جستجو را فقط به آن دسته از وسایل نقلیه با تمام ویژگی‌های یک VehicleAttributeList محدود می‌کند. در هر لیست، یک وسیله نقلیه باید با تمام ویژگی ها مطابقت داشته باشد. این فیلد یک عملیات ربط/و در هر VehicleAttributeList و عملیات تفکیک/OR فراگیر در مجموعه VehicleAttributeList است.
order_ by	VehicleMatchOrder مورد نیاز. معیار سفارش مورد نظر را برای نتایج مشخص می کند.
include_ back_ to_ back	bool این نشان می دهد که آیا وسایل نقلیه با یک سفر فعال واجد شرایط این جستجو هستند یا خیر. این فیلد فقط زمانی استفاده می شود که current_trips_present مشخص نشده باشد. هنگامی که current_trips_present مشخص نشده باشد و این فیلد false باشد، وسایل نقلیه با سفرهای اختصاص داده شده از نتایج جستجو حذف می شوند. زمانی که current_trips_present مشخص نشده باشد و این قسمت true باشد، نتایج جستجو می‌تواند شامل وسایل نقلیه با یک سفر فعال باشد که وضعیت آن ENROUTE_TO_DROPOFF است. هنگامی که current_trips_present مشخص شده است، این فیلد را نمی توان روی true تنظیم کرد. مقدار پیش فرض false است.
trip_ id	string نشان دهنده سفر مرتبط با این SearchVehicleRequest است.
current_ trips_ present	CurrentTripsPresent این نشان می دهد که آیا وسایل نقلیه با سفرهای فعال واجد شرایط این جستجو هستند یا خیر. اگر trip_type شامل SHARED باشد، باید روی چیزی غیر از CURRENT_TRIPS_PRESENT_UNSPECIFIED تنظیم شود.
filter	string اختیاری. یک درخواست فیلتر برای اعمال هنگام جستجوی وسایل نقلیه. برای نمونه هایی از نحو فیلتر http://aip.dev/160 را ببینید. این فیلد به‌منظور جایگزینی فیلدهای required_attributes ، required_one_of_attributes و required_one_of_attributes_sets طراحی شده است. اگر یک مقدار غیر خالی در اینجا مشخص شده باشد، فیلدهای زیر باید خالی باشند: required_attributes ، required_one_of_attributes ، و required_one_of_attributes_sets . این فیلتر به‌عنوان یک بند AND با محدودیت‌های دیگر مانند minimum_capacity یا vehicle_types عمل می‌کند. توجه داشته باشید که تنها جستارهای پشتیبانی شده مربوط به ویژگی های وسیله نقلیه هستند (به عنوان مثال، attributes.<key> = <value> یا attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). حداکثر تعداد محدودیت های مجاز در یک جستار فیلتر 50 است. همچنین، تمام ویژگی ها به عنوان رشته ذخیره می شوند، بنابراین تنها مقایسه های پشتیبانی شده در برابر ویژگی ها، مقایسه رشته ها هستند. به منظور مقایسه با مقادیر یا مقادیر بولی، مقادیر باید به صراحت نقل قول شوند تا به عنوان رشته در نظر گرفته شوند (به عنوان مثال، attributes.<key> = "10" یا attributes.<key> = "true" ).

CurrentTripsPresent

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

Enums
CURRENT_TRIPS_PRESENT_UNSPECIFIED	در دسترس بودن وسایل نقلیه با سفرهای موجود توسط قسمت include_back_to_back کنترل می شود.
NONE	وسایل نقلیه بدون سفر می توانند در نتایج جستجو ظاهر شوند. وقتی از این مقدار استفاده می شود، include_back_to_back نمی تواند true باشد.
ANY	وسایل نقلیه با حداکثر 5 سفر فعلی و 10 ایستگاه بین راه در نتایج جستجو گنجانده شده است. وقتی از این مقدار استفاده می شود، include_back_to_back نمی تواند true باشد.

سفارش مسابقه خودرو

ترتیب مطابقت های وسیله نقلیه را در پاسخ مشخص می کند.

Enums
UNKNOWN_VEHICLE_MATCH_ORDER	پیش‌فرض، برای ترتیب تطبیق خودروهای نامشخص یا ناشناخته استفاده می‌شود.
PICKUP_POINT_ETA	ترتیب صعودی بر اساس زمان رانندگی وسیله نقلیه تا نقطه وانت.
PICKUP_POINT_DISTANCE	ترتیب صعودی بر اساس فاصله رانندگی وسیله نقلیه تا نقطه وانت.
DROPOFF_POINT_ETA	ترتیب صعودی بر اساس زمان رانندگی وسیله نقلیه تا نقطه سقوط. این سفارش تنها در صورتی قابل استفاده است که نقطه خروج در درخواست مشخص شده باشد.
PICKUP_POINT_STRAIGHT_DISTANCE	ترتیب صعودی بر اساس فاصله خط مستقیم از آخرین مکان گزارش شده خودرو تا نقطه تحویل.
COST	ترتیب صعودی بر اساس هزینه بازی پیکربندی شده. هزینه مسابقه به عنوان یک محاسبه وزنی بین فاصله خط مستقیم و ETA تعریف می شود. وزن‌ها با مقادیر پیش‌فرض تنظیم می‌شوند و به ازای هر مشتری قابل تغییر هستند. اگر این وزن ها برای پروژه شما نیاز به تغییر دارند، لطفاً با پشتیبانی Google تماس بگیرید.

Search Vehicles Response

پیام پاسخ SearchVehicles .

فیلدها
matches[]	VehicleMatch فهرست خودروهایی که با معیارهای SearchVehiclesRequest مطابقت دارند، طبق قسمت SearchVehiclesRequest.order_by مرتب شده اند.

SpeedReading Interval

نشانگر تراکم ترافیک در یک بخش پیوسته از یک مسیر. با توجه به مسیری با نقاط P_0، P_1، ...، P_N (شاخص مبتنی بر صفر)، SpeedReadingInterval یک بازه را تعریف می‌کند و ترافیک آن را با استفاده از دسته‌های زیر توصیف می‌کند.

فیلدها
start_ polyline_ point_ index	int32 شاخص شروع این بازه در مسیر. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.
end_ polyline_ point_ index	int32 شاخص پایانی این بازه در مسیر. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.
speed	Speed سرعت ترافیک در این بازه.

سرعت

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

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

StopLocation

مکان واقعی که در آن توقف (انتقال / خروج) اتفاق افتاده است.

فیلدها
point	LatLng مورد نیاز. مکان واقعی را نشان می دهد.
timestamp	Timestamp زمان وقوع توقف را نشان می دهد.
stop_time (deprecated)	Timestamp این مورد منسوخ شده است! فقط ورودی منسوخ شده است. از قسمت مهر زمان استفاده کنید.

TerminalLocation

موقعیت یک ایستگاه بین راه را توصیف می کند.

فیلدها
point	LatLng مورد نیاز. نشان دهنده محل یک ایستگاه بین راهی سفر است.
terminal_point_id (deprecated)	TerminalPointId این مورد منسوخ شده است! منسوخ شده: به جای آن فیلد point را مشخص کنید.
access_point_id (deprecated)	string این مورد منسوخ شده است! منسوخ شده: به جای آن فیلد point را مشخص کنید.
trip_id (deprecated)	string این مورد منسوخ شده است! منسوخ شده است.
terminal_location_type (deprecated)	WaypointType این مورد منسوخ شده است! منسوخ شده: Vehicle.waypoint این داده ها را خواهد داشت.

TerminalPointId

این مورد منسوخ شده است!

منسوخ شده: TerminalPoints دیگر در Fleet Engine پشتیبانی نمی شود. به جای آن از TerminalLocation.point استفاده کنید.

فیلدها
value (deprecated)	string این مورد منسوخ شده است! منسوخ شده است.
Id فیلد اتحادیه منسوخ شده است. Id می تواند تنها یکی از موارد زیر باشد:
place_id (deprecated)	string این مورد منسوخ شده است! منسوخ شده است.
generated_id (deprecated)	string این مورد منسوخ شده است! منسوخ شده است.

TrafficPolylineData

شرایط ترافیکی در مسیر مورد انتظار خودرو.

فیلدها
traffic_ rendering	VisualTrafficReportPolylineRendering یک نمایش چند خطی از سرعت ترافیک برای همه مناطق در طول یک مسیر از سفر مشتری.

سفر

فراداده سفر

فیلدها
name	string فقط خروجی در قالب "provider/{provider}/trips/{trip}"
vehicle_ id	string شناسه وسیله نقلیه ای که این سفر را انجام می دهد.
trip_ status	TripStatus وضعیت فعلی سفر
trip_ type	TripType نوع سفر.
pickup_ point	TerminalLocation مکانی که مشتری نشان می دهد که آنها را تحویل می گیرند.
actual_ pickup_ point	StopLocation فقط ورودی مکان واقعی زمان و مکان تحویل مشتری این فیلد برای ارائه‌دهنده بازخورد در مورد اطلاعات دریافت واقعی است.
actual_ pickup_ arrival_ point	StopLocation فقط ورودی زمان و مکان واقعی ورود راننده به نقطه وانت. این فیلد برای ارائه‌دهنده است تا در مورد اطلاعات ورود واقعی در نقطه تحویل بازخورد ارائه دهد.
pickup_ time	Timestamp فقط خروجی یا زمان تخمینی آینده که سوار(ها) سوار می شوند، یا زمان واقعی که سوار می شوند.
intermediate_ destinations[]	TerminalLocation توقف های میانی به منظور درخواست سفر (علاوه بر تحویل و تحویل). در ابتدا این برای سفرهای مشترک پشتیبانی نخواهد شد.
intermediate_ destinations_ version	Timestamp آخرین باری را که intermediate_destinations تغییر کرده است را نشان می دهد. سرور شما باید این مقدار را کش کند و هنگام به‌روزرسانی intermediate_destination_index آن را در UpdateTripRequest ارسال کند تا اطمینان حاصل شود که intermediate_destinations تغییر نکرده است.
intermediate_ destination_ index	int32 هنگامی که TripStatus ENROUTE_TO_INTERMEDIATE_DESTINATION باشد، عددی بین [0..N-1] نشان می دهد که وسیله نقلیه از کدام مقصد میانی بعدی عبور خواهد کرد. هنگامی که TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION است، عددی بین [0..N-1] نشان می دهد که وسیله نقلیه در کدام مقصد میانی قرار دارد. ارائه دهنده این مقدار را تعیین می کند. اگر intermediate_destinations وجود نداشته باشد، این فیلد نادیده گرفته می شود.
actual_ intermediate_ destination_ arrival_ points[]	StopLocation فقط ورودی زمان و مکان واقعی ورود راننده به یک مقصد میانی. این فیلد برای ارائه‌دهنده ارائه بازخورد در مورد اطلاعات ورود واقعی به مقصدهای میانی است.
actual_ intermediate_ destinations[]	StopLocation فقط ورودی زمان و مکان واقعی زمانی و مکانی که مشتری از یک مقصد میانی تحویل گرفته شده است. این فیلد برای ارائه‌دهنده است تا بازخوردی درباره اطلاعات دریافت واقعی در مقاصد میانی ارائه دهد.
dropoff_ point	TerminalLocation مکانی که مشتری نشان می دهد که آنها را ترک خواهند کرد.
actual_ dropoff_ point	StopLocation فقط ورودی زمان و مکان واقعی زمان و مکان خروج مشتری. این فیلد برای ارائه‌دهنده است تا در مورد اطلاعات حذف واقعی بازخورد ارائه کند.
dropoff_ time	Timestamp فقط خروجی یا زمان تخمینی آینده که سوار(ها) در مقصد نهایی پیاده می شوند، یا زمان واقعی پیاده شدن آنها.
remaining_ waypoints[]	TripWaypoint فقط خروجی مسیر کامل از مکان فعلی تا نقطه افت، شامل. این مسیر می تواند شامل نقاط بین سفرهای دیگر باشد.
vehicle_ waypoints[]	TripWaypoint این فیلد از سفارش دستی ایستگاه های بین راه برای سفر پشتیبانی می کند. این شامل تمام ایستگاه های بین راهی برای وسیله نقلیه تعیین شده، و همچنین ایستگاه های حمل و نقل و تحویل برای این سفر است. اگر این سفر به وسیله نقلیه اختصاص نیافته باشد ، موتور ناوگان این میدان را نادیده می گیرد. به دلایل حریم خصوصی ، این قسمت فقط توسط سرور در تماس های UpdateTrip و CreateTrip جمع می شود ، نه در تماس های GetTrip .
route[]	LatLng فقط خروجی مسیر پیش بینی شده برای این سفر به اولین ورودی در uring_waypoints. توجه داشته باشید که اولین نقطه راه ممکن است متعلق به یک سفر متفاوت باشد.
current_ route_ segment	string فقط خروجی یک مسیر رمزگذاری شده به سمت مسیر بعدی. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است.
current_ route_ segment_ version	Timestamp فقط خروجی نشان می دهد آخرین باری که مسیر اصلاح شده است. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است.
current_ route_ segment_ traffic	ConsumableTrafficPolyline فقط خروجی شرایط ترافیک را در طول current_route_segment در صورت وجود نشان می دهد. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است.
current_ route_ segment_ traffic_ version	Timestamp فقط خروجی آخرین باری را نشان می دهد که current_route_segment_traffic route_sement_traffic اصلاح شده است. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است.
current_ route_ segment_ end_ point	TripWaypoint فقط خروجی نقطه راه که در آن به پایان می رسد_ current_route_segment پایان می یابد.
remaining_ distance_ meters	Int32Value فقط خروجی فاصله رانندگی باقیمانده در قسمت current_route_segment . اگر سفر به وسیله نقلیه اختصاص نداشته باشد ، یا سفر به اتمام یا لغو می شود ، مقدار نامشخص است.
eta_ to_ first_ waypoint	Timestamp فقط خروجی ETA به نقطه راه بعدی (اولین ورودی در قسمت remaining_waypoints ). اگر سفر به وسیله نقلیه اختصاص نیافته باشد ، یا سفر غیرفعال است (تکمیل یا لغو شده) مقدار نامشخص است.
remaining_ time_ to_ first_ waypoint	Duration فقط خروجی مدت زمان بازگشت داده های سفر به زمان Trip.eta_to_first_waypoint . ETA_TO_FIRST_WAYPOINT. اگر سفر به وسیله نقلیه اختصاص نیافته باشد ، یا سفر غیرفعال است (تکمیل یا لغو شده) مقدار نامشخص است.
remaining_ waypoints_ version	Timestamp فقط خروجی آخرین باری را نشان می دهد که remaining_waypoints تغییر یافته است (یک ایستگاه راه اضافه شد ، حذف شد یا تغییر یافت).
remaining_ waypoints_ route_ version	Timestamp فقط خروجی آخرین باری را نشان می دهد که remaining_waypoints.path_to_waypoint و remaining_waypoints.traffic_to_waypoint اصلاح شد. برنامه مشتری شما باید این مقدار را ذخیره کرده و آن را در GetTripRequest منتقل کند تا اطمینان حاصل شود که مسیرها و ترافیک برای remaining_waypoints فقط در صورت بروزرسانی بازگردانده می شوند.
number_ of_ passengers	int32 تغییرناپذیر. تعداد مسافران در این سفر را نشان می دهد و راننده را شامل نمی شود. یک وسیله نقلیه باید ظرفیت موجود در یک پاسخ SearchVehicles را در دسترس داشته باشد.
last_ location	VehicleLocation فقط خروجی آخرین مکان گزارش شده وسیله نقلیه را در طول مسیر نشان می دهد.
last_ location_ snappable	bool فقط خروجی نشان می دهد که آیا last_location وسیله نقلیه را می توان به جریان فعلی_Route_Segment منتقل کرد. false اگر last_location یا current_route_segment وجود ندارد. توسط موتور ناوگان محاسبه می شود. هرگونه بروزرسانی از مشتریان نادیده گرفته می شود.
view	TripView زیر مجموعه زمینه های سفر که جمعیتی دارند و نحوه تفسیر آنها.

سه گانه

وضعیت سفر نشان دهنده پیشرفت آن است.

Enums
UNKNOWN_TRIP_STATUS	پیش فرض ، برای وضعیت سفر نامشخص یا ناشناخته استفاده می شود.
NEW	سفر تازه ایجاد شده.
ENROUTE_TO_PICKUP	راننده در راه وانت است.
ARRIVED_AT_PICKUP	راننده به نقطه وانت رسیده است.
ARRIVED_AT_INTERMEDIATE_DESTINATION	راننده به یک مقصد میانی رسیده است و منتظر سوار است.
ENROUTE_TO_INTERMEDIATE_DESTINATION	راننده در حال رفتن به یک مقصد میانی است (نه نقطه سقوط).
ENROUTE_TO_DROPOFF	راننده سوار را برداشته و در حال رفتن به مقصد بعدی است.
COMPLETE	سوار کنار گذاشته شده و سفر کامل است.
CANCELED	این سفر قبل از وانت توسط راننده ، سوار یا ارائه دهنده Rideshare لغو شد.

نوع سه گانه

نوع سفر.

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

عکسبرداری

انتخاب برای مجموعه های مختلف زمینه های سفر در پاسخ GetTrip . برای زمینه به AIP-157 مراجعه کنید. احتمالاً نماهای اضافی اضافه می شود.

Enums
TRIP_VIEW_UNSPECIFIED	مقدار پیش فرض برای سازگاری به عقب ، API به طور پیش فرض به نمای SDK خواهد بود. برای اطمینان از ثبات و پشتیبانی ، به مشتریان توصیه می شود یک TripView غیر از SDK را انتخاب کنند.
SDK	شامل زمینه هایی است که ممکن است با استفاده از کتابخانه های در دسترس عموم قابل تفسیر یا پشتیبانی نباشند.
JOURNEY_SHARING_V1S	زمینه های سفر برای مورد استفاده از اشتراک گذاری سفر جمع شده اند. این نمای برای ارتباطات سرور به سرور در نظر گرفته شده است.

نقطه راهرو

یک نقطه توقف در مسیر وسیله نقلیه یا یک نقطه پایان در سفر وسیله نقلیه را توصیف می کند.

فیلدها
location	TerminalLocation محل این ایستگاه راه.
trip_ id	string سفر مرتبط با این نقطه.
waypoint_ type	WaypointType نقش این Waypoint در این سفر مانند وانت یا رها کردن ایفا می کند.
path_ to_ waypoint[]	LatLng مسیر از مسیر قبلی به سمت مسیر فعلی. تعریف نشده برای اولین نقطه در یک لیست. این قسمت فقط در صورت درخواست جمع می شود.
encoded_ path_ to_ waypoint	string مسیر رمزگذاری شده از نقطه راه قبلی به نقطه راه فعلی. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است.
traffic_ to_ waypoint	ConsumableTrafficPolyline شرایط ترافیکی در طول مسیر به این نقطه. توجه داشته باشید که ترافیک فقط برای Google Map Platform Rides و Deliveries Solution مشتریان در دسترس است.
distance_ meters	Int32Value فاصله مسیر از نقطه راه قبلی تا نقطه راه فعلی. تعریف نشده برای اولین نقطه در یک لیست.
eta	Timestamp زمان تخمینی ورود در این نقطه. تعریف نشده برای اولین نقطه در یک لیست.
duration	Duration زمان سفر از مسیر قبلی به این نقطه. تعریف نشده برای اولین نقطه در یک لیست.

به روزرسانی

پیام درخواست UpdateTrip.

فیلدها
header	RequestHeader هدر درخواست موتور ناوگان استاندارد.
name	string مورد نیاز. باید در providers/{provider}/trips/{trip} باشد. ارائه دهنده باید شناسه پروژه (به عنوان مثال ، sample-consumer-project ) پروژه Google Cloud باشد که حساب خدمات این تماس عضو است.
trip	Trip مورد نیاز. سفر مرتبط با بروزرسانی. زمینه های زیر توسط موتور ناوگان نگهداری می شود. آنها را با استفاده از Trip.update به روز نکنید. current_route_segment current_route_segment_end_point current_route_segment_traffic current_route_segment_traffic_version current_route_segment_version dropoff_time eta_to_next_waypoint intermediate_destinations_version last_location name number_of_passengers pickup_time remaining_distance_meters remaining_time_to_first_waypoint remaining_waypoints remaining_waypoints_version route هنگامی که Trip.vehicle_id را برای یک سفر مشترک به روز می کنید ، باید لیست Trip.vehicle_waypoints را تهیه کنید تا ترتیب ایستگاه های راه باقی مانده را مشخص کنید ، در غیر این صورت سفارش مشخص نمی شود. هنگامی که Trip.vehicle_waypoints مشخص می کنید ، لیست باید شامل تمام نقاط راه باقی مانده از سفرهای وسیله نقلیه باشد ، بدون اینکه نقطه راه اضافی باشد. شما باید این نقاط راه را به گونه ای سفارش دهید که برای یک سفر معین ، نقطه وانت قبل از مقصد واسطه ای باشد و تمام مقصد های میانی قبل از نقطه کشویی بیایند. نقاط دیدنی یک سفر EXCLUSIVE نباید با هیچ سفر دیگری ارتباط برقرار کند. زمینه های trip_id ، waypoint_type و location استفاده می شود و سایر زمینه های Tripwaypoint در vehicle_waypoints نادیده گرفته می شوند. برای جلوگیری از شرط مسابقه برای سفرهای با مقصد های متعدد ، باید هنگام بروزرسانی وضعیت سفر به ENROUTE_TO_INTERMEDIATE_DESTINATION Trip.intermediate_destinations_version ارائه دهید. Trip.intermediate_destinations_version گذشت باید مطابق با نسخه موتور ناوگان باشد. اگر اینگونه نباشد ، درخواست انجام نمی شود.
update_ mask	FieldMask مورد نیاز. ماسک میدانی که نشان می دهد کدام قسمت در سفر برای به روزرسانی است. update_mask باید حداقل یک قسمت داشته باشد.

UpdateveHicLeatTributesRequest

پیام درخواست UpdateVehicleAttributes .

فیلدها
header	RequestHeader هدر درخواست موتور ناوگان استاندارد.
name	string مورد نیاز. باید در providers/{provider}/vehicles/{vehicle} باشد. ارائه دهنده باید شناسه پروژه (به عنوان مثال ، sample-cloud-project ) پروژه Google Cloud باشد که حساب خدمات این تماس عضو است.
attributes[]	VehicleAttribute مورد نیاز. ویژگی های وسیله نقلیه برای به روزرسانی. ویژگی های غیرقابل تغییر تغییر نکرده یا حذف نمی شوند.

به روزرسانی

پیام پاسخ UpdateVehicleAttributes .

فیلدها
attributes[]	VehicleAttribute مورد نیاز. لیست کامل به روز شده از ویژگی های وسیله نقلیه ، از جمله ویژگی های جدید ، تغییر یافته و دست نخورده.

Updatevehiclerequest

`پیام درخواست UpdateveHicle.

فیلدها
header	RequestHeader هدر درخواست موتور ناوگان استاندارد.
name	string مورد نیاز. باید در providers/{provider}/vehicles/{vehicle} باشد. {ارائه دهنده} باید شناسه پروژه (به عنوان مثال ، sample-cloud-project ) پروژه Google Cloud باشد که حساب خدمات این تماس عضو است.
vehicle	Vehicle مورد نیاز. ارزش موجودیت Vehicle برای اعمال. هنگام به روزرسانی یک Vehicle ، ممکن است قسمتهای زیر به روز شوند زیرا توسط سرور اداره می شوند. available_capacity current_route_segment_version current_trips name waypoints_version اگر قسمت attributes به روز شود ، تمام ویژگی های وسیله نقلیه با ویژگی های ارائه شده در درخواست جایگزین می شوند. اگر می خواهید فقط برخی از ویژگی ها را به روز کنید ، به روش UpdateVehicleAttributes مراجعه کنید. به همین ترتیب ، قسمت waypoints می تواند به روز شود ، اما باید تمام ایستگاه های راه را که در حال حاضر در وسیله نقلیه هستند ، داشته باشد و هیچ نقطه راه دیگری وجود ندارد.
update_ mask	FieldMask مورد نیاز. ماسک میدانی که نشان می دهد کدام قسمت از Vehicle برای به روزرسانی است. حداقل یک نام فیلد باید ارائه شود.

وسیله نقلیه

ابرداده وسیله نقلیه.

فیلدها
name	string فقط خروجی نام منحصر به فرد این وسیله نقلیه. قالب providers/{provider}/vehicles/{vehicle} .
vehicle_ state	VehicleState حالت وسیله نقلیه
supported_ trip_ types[]	TripType انواع سفر پشتیبانی شده توسط این وسیله نقلیه.
current_ trips[]	string فقط خروجی لیست trip_id برای سفرهایی که در حال حاضر به این وسیله نقلیه اختصاص داده شده است.
last_ location	VehicleLocation آخرین مکان گزارش شده وسیله نقلیه.
maximum_ capacity	int32 تعداد کل سواران این وسیله نقلیه می تواند حمل کند. راننده در این مقدار در نظر گرفته نمی شود. این مقدار باید بیشتر از یا مساوی باشد.
attributes[]	VehicleAttribute لیست ویژگی های وسیله نقلیه. یک وسیله نقلیه می تواند حداکثر 100 ویژگی داشته باشد و هر ویژگی باید یک کلید منحصر به فرد داشته باشد.
vehicle_ type	VehicleType مورد نیاز. نوع این وسیله نقلیه می توان برای فیلتر کردن وسایل نقلیه در نتایج SearchVehicles استفاده کرد. همچنین بر محاسبات ETA و مسیر تأثیر می گذارد.
license_ plate	LicensePlate اطلاعات پلاک برای وسیله نقلیه.
route[] (deprecated)	TerminalLocation این مورد مستهلک می شود! deprecated: به جای آن از Vehicle.waypoints استفاده کنید.
current_ route_ segment	string چند خطی که مسیری را که برنامه راننده قصد دارد تا ایستگاه بین راهی بعدی طی کند را مشخص می کند. این لیست همچنین در Trip.current_route_segment برای کلیه سفرهای فعال اختصاص داده شده به وسیله نقلیه بازگردانده می شود. توجه: این قسمت فقط برای استفاده توسط درایور SDK در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است.
current_ route_ segment_ traffic	TrafficPolylineData فقط ورودی موتور ناوگان از این اطلاعات برای بهبود اشتراک سفر استفاده می کند. توجه: این قسمت فقط برای استفاده توسط درایور SDK در نظر گرفته شده است.
current_ route_ segment_ version	Timestamp فقط خروجی زمان تنظیم current_route_segment تنظیم شد. می توان آن را توسط مشتری ذخیره کرد و در درخواست های GetVehicle در آینده برای جلوگیری از بازگشت مسیرهای تغییر نکرده است.
current_ route_ segment_ end_ point	TripWaypoint نقطه راه که در آن به پایان می رسد_ current_route_segment پایان می یابد. این می تواند توسط درایورها در تماس های UpdateVehicle یا به عنوان یک نقطه راه سفر کامل ، یک ایستگاه Waypoint LatLng یا به عنوان آخرین LatLng از current_route_segment تهیه شود. موتور ناوگان در صورت عدم مشخص شدن به طور کامل ، تمام تلاش خود را می کند تا در یک مسیر واقعی در یک مسیر واقعی قرار بگیرد. این قسمت در تماس های UpdateVehicle نادیده گرفته می شود مگر اینکه current_route_segment نیز مشخص شده باشد.
remaining_ distance_ meters	Int32Value فاصله رانندگی باقیمانده برای current_route_segment . این مقدار همچنین در Trip.remaining_distance_meters برای کلیه سفرهای فعال اختصاص داده شده به وسیله نقلیه بازگردانده می شود. اگر قسمت current_route_segment خالی باشد ، مقدار نامشخص است.
eta_ to_ first_ waypoint	Timestamp ETA به اولین ورودی در قسمت waypoints . اگر قسمت waypoints خالی باشد یا Vehicle.current_route_segment خالی باشد ، مقدار نامشخص است. هنگام به روزرسانی یک وسیله نقلیه ، remaining_time_seconds در همان درخواست بر eta_to_first_waypoint برتری می گیرد.
remaining_ time_ seconds	Int32Value فقط ورودی زمان رانندگی باقیمانده برای current_route_segment . اگر قسمت waypoints خالی باشد یا Vehicle.current_route_segment خالی باشد ، مقدار نامشخص است. اگر همه طرفین از همان ساعت استفاده می کنند ، این مقدار باید current_time eta_to_first_waypoint مطابقت داشته باشد. هنگام به روزرسانی یک وسیله نقلیه ، remaining_time_seconds در همان درخواست بر eta_to_first_waypoint برتری می گیرد.
waypoints[]	TripWaypoint نقاط بین راهی که به این وسیله نقلیه اختصاص داده شده است.
waypoints_ version	Timestamp فقط خروجی آخرین باری که قسمت waypoints به روز شد. مشتریان باید این مقدار را ذخیره کرده و آن را در GetVehicleRequest منتقل کنند تا اطمینان حاصل شود که قسمت waypoints فقط در صورت بروزرسانی بازگردانده می شود.
back_ to_ back_ enabled	bool نشان می دهد که آیا راننده سفرهای برگشت به عقب را می پذیرد یا خیر. اگر true ، SearchVehicles ممکن است وسیله نقلیه را شامل شود حتی اگر در حال حاضر به یک سفر اختصاص داده شود. مقدار پیش فرض false است.
navigation_ status	NavigationStatus وضعیت ناوبری وسیله نقلیه.
device_ settings	DeviceSettings فقط ورودی اطلاعات مربوط به تنظیمات موجود در دستگاه تلفن همراه که توسط درایور استفاده می شود.

نوع

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

فیلدها
category	Category دسته نوع وسیله نقلیه

دسته بندی

دسته های نوع وسیله نقلیه

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

توزیع کننده

یک ویژگی وسیله نقلیه را به عنوان یک جفت ارزش کلید توصیف می کند. طول رشته "کلید: مقدار" نمی تواند از 256 کاراکتر تجاوز کند.

فیلدها
key	string کلید ویژگی کلیدها ممکن است حاوی شخصیت روده بزرگ نباشند (:).
value	string مقدار ویژگی
Union Field vehicle_attribute_value . مقدار این ویژگی می تواند در رشته ، بول یا دو نوع باشد. vehicle_attribute_value فقط می تواند یکی از موارد زیر باشد:
string_ value	string مقدار ویژگی تایپ شده رشته. توجه: این یکسان با قسمت value است که در نهایت کاهش می یابد. برای ایجاد یا به روزرسانی روش ها ، از هر قسمت استفاده می شود ، اما استفاده از string_value به شدت توصیه می شود. اگر هر دو string_value و value تنظیم شوند ، باید یکسان باشند یا خطایی پرتاب شود. هر دو قسمت در پاسخ ها جمع شده اند.
bool_ value	bool مقدار ویژگی تایپ شده بولی.
number_ value	double مقدار ویژگی Double Typed.

وسیله نقلیه

مجموعه ای از لیست های لیست برای ویژگی های وسیله نقلیه.

فیلدها
attributes[]	VehicleAttribute لیستی از ویژگی های این مجموعه.

جابجایی وسایل نقلیه

مکان ، سرعت و عنوان یک وسیله نقلیه در یک نقطه از زمان.

فیلدها
location	LatLng محل وسیله نقلیه هنگامی که به موتور ناوگان ارسال می شود ، مکان وسیله نقلیه یک مکان GPS است. هنگامی که آن را در یک پاسخ دریافت می کنید ، مکان وسیله نقلیه می تواند یک مکان GPS ، یک مکان تکمیلی یا مکان تخمین زده شده دیگر باشد. منبع در location_sensor مشخص شده است.
horizontal_accuracy (deprecated)	DoubleValue این مورد مستهلک می شود! deprecated: به جای آن از latlng_accuracy استفاده کنید.
latlng_ accuracy	DoubleValue صحت location در متر به عنوان شعاع.
heading	Int32Value جهت وسیله نقلیه در درجه حرکت می کند. 0 نمایانگر شمال است. دامنه معتبر [0،360) است.
bearing_accuracy (deprecated)	DoubleValue این مورد مستهلک می شود! کاهش یافته: به جای آن از heading_accuracy استفاده کنید.
heading_ accuracy	DoubleValue صحت heading در درجه.
altitude	DoubleValue ارتفاع در متر بالاتر از WGS84.
vertical_accuracy (deprecated)	DoubleValue این مورد مستهلک می شود! کاهش یافته: به جای آن از altitude_accuracy استفاده کنید.
altitude_ accuracy	DoubleValue دقت altitude در متر.
speed_kmph (deprecated)	Int32Value این مورد مستهلک می شود! سرعت وسیله نقلیه در کیلومتر در ساعت. کاهش یافته: به جای آن از speed استفاده کنید.
speed	DoubleValue سرعت وسیله نقلیه در متر در ثانیه
speed_ accuracy	DoubleValue دقت speed در متر در ثانیه.
update_ time	Timestamp زمان گزارش location توسط سنسور طبق ساعت سنسور گزارش شده است.
server_ time	Timestamp فقط خروجی زمانی که سرور اطلاعات مکان را دریافت کرد.
location_ sensor	LocationSensor ارائه دهنده داده های مکان (به عنوان مثال ، GPS ).
is_ road_ snapped	BoolValue این که آیا location به یک جاده رسیده است.
is_ gps_ sensor_ enabled	BoolValue فقط ورودی نشان می دهد که آیا سنسور GPS در دستگاه تلفن همراه فعال است یا خیر.
time_ since_ update	Int32Value فقط ورودی زمان (در ثانیه) از آنجا که این مکان برای اولین بار به سرور ارسال شد. این برای اولین به روزرسانی صفر خواهد بود. اگر زمان ناشناخته باشد (به عنوان مثال ، وقتی برنامه دوباره شروع می شود) ، این مقدار به صفر می رسد.
num_stale_updates (deprecated)	Int32Value این مورد مستهلک می شود! فقط ورودی مستهلک: اکنون سیگنال های دیگر برای تعیین اینکه آیا یک مکان بی نظیر است ، استفاده می شود.
raw_ location	LatLng محل کار وسیله نقلیه خام (از طریق راهپیمایی جاده ای).
raw_ location_ time	Timestamp Timestamp مرتبط با محل خام.
raw_ location_ sensor	LocationSensor منبع محل خام. پیش فرض GPS .
raw_ location_ accuracy	DoubleValue صحت raw_location به عنوان شعاع ، در متر.
supplemental_ location	LatLng مکان تکمیلی ارائه شده توسط برنامه یکپارچه سازی.
supplemental_ location_ time	Timestamp Timestamp مرتبط با محل تکمیلی.
supplemental_ location_ sensor	LocationSensor منبع محل تکمیلی. پیش فرض به CUSTOMER_SUPPLIED_LOCATION .
supplemental_ location_ accuracy	DoubleValue دقت در supplemental_location به عنوان شعاع ، در متر.
road_snapped (deprecated)	bool این مورد مستهلک می شود! deprecated: به جای آن از is_road_snapped استفاده کنید.

وسیله نقلیه

شامل وسیله نقلیه و تخمین های مربوط به وسیله نقلیه ای است که با نقاط سفرهای فعال برای SearchVehiclesRequest مطابقت دارد.

فیلدها
vehicle	Vehicle مورد نیاز. وسیله نقلیه ای که با درخواست مطابقت دارد.
vehicle_ pickup_ eta	Timestamp رانندگی وسیله نقلیه ETA به نقطه وانت مشخص شده در درخواست. مقدار خالی نشانگر عدم موفقیت در محاسبه ETA برای وسیله نقلیه است. اگر SearchVehiclesRequest.include_back_to_back true بود و این وسیله نقلیه یک سفر فعال دارد ، vehicle_pickup_eta زمان لازم برای تکمیل سفر فعال فعلی را شامل می شود.
vehicle_ pickup_ distance_ meters	Int32Value فاصله از محل فعلی خودرو تا نقطه وانت مشخص شده در درخواست ، از جمله هر وانت متوسط ​​یا نقاط قطره ای برای سفرهای موجود. این فاصله شامل فاصله محاسبه شده (مسیر) محاسبه شده ، به علاوه فاصله مستقیم خط بین نقطه پایان ناوبری و نقطه وانت درخواست شده است. (فاصله بین نقطه پایان ناوبری و نقطه وانت درخواست شده به طور معمول اندک است.) یک مقدار خالی نشانگر خطایی در محاسبه فاصله است.
vehicle_ pickup_ straight_ line_ distance_ meters	Int32Value مورد نیاز. فاصله مستقیم بین وسیله نقلیه و نقطه وانت مشخص شده در درخواست.
vehicle_ dropoff_ eta	Timestamp رانندگی کامل وسیله نقلیه ETA به نقطه سقوط مشخص شده در درخواست. ETA شامل توقف در هر نقطه از ایستگاه های قبل از dropoff_point مشخص شده در درخواست است. این مقدار فقط در صورت مشخص شدن نقطه افت در درخواست جمع می شود. مقدار خالی خطایی را برای محاسبه ETA نشان می دهد.
vehicle_ pickup_ to_ dropoff_ distance_ meters	Int32Value فاصله رانندگی وسیله نقلیه (در متر) از نقطه وانت تا نقطه افت مشخص شده در درخواست. فاصله فقط بین دو نقطه است و شامل مکان وسیله نقلیه یا هر نقطه دیگری نیست که باید قبل از بازدید وسیله نقلیه از نقطه وانت یا نقطه قطره بازدید شود. مقدار فقط در صورت مشخص شدن یک dropoff_point در درخواست جمع می شود. مقدار خالی نشانگر عدم موفقیت در محاسبه فاصله از وانت برای کاهش نقطه مشخص شده در درخواست است.
trip_ type	TripType مورد نیاز. نوع سفر درخواستی که برای محاسبه ETA در نقطه وانت استفاده شده است.
vehicle_ trips_ waypoints[]	Waypoint لیست سفارش داده شده از ایستگاه های راه استفاده شده برای محاسبه ETA. این لیست شامل موقعیت مکانی وسیله نقلیه ، وانت سفرهای فعال برای وسیله نقلیه و نقاط وانت ارائه شده در درخواست است. یک لیست خالی نشانگر عدم موفقیت در محاسبه ETA برای وسیله نقلیه است.
vehicle_ match_ type	VehicleMatchType نوع مطابقت وسیله نقلیه.
requested_ ordered_ by	VehicleMatchOrder سفارش درخواست شده برای مرتب سازی مسابقات وسیله نقلیه.
ordered_ by	VehicleMatchOrder ترتیب واقعی که برای این وسیله نقلیه استفاده شده است. به طور معمول این با قسمت "Order_By" از درخواست مطابقت دارد. با این حال ، در شرایط خاص مانند خطای سرور داخلی ، ممکن است از روش متفاوتی استفاده شود (مانند PICKUP_POINT_STRAIGHT_DISTANCE ).

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

نوع مطابقت وسیله نقلیه.

Enums
UNKNOWN	نوع مسابقه ناشناخته وسیله نقلیه
EXCLUSIVE	این وسیله نقلیه در حال حاضر هیچ سفری به آن ندارد و می تواند به نقطه وانت برود.
BACK_TO_BACK	این وسیله نقلیه در حال حاضر به یک سفر اختصاص داده شده است ، اما می تواند پس از اتمام سفر در حال پیشرفت به نقطه وانت برود. محاسبات ETA و فاصله سفر موجود را در نظر می گیرد.
CARPOOL	این وسیله نقلیه از ظرفیت کافی برای یک سواری مشترک برخوردار است.
CARPOOL_BACK_TO_BACK	این وسیله نقلیه قبل از حرکت به نقطه وانت ، سفر فعلی و فعال خود را به پایان می رساند. محاسبات ETA و فاصله سفر موجود را در نظر می گیرد.

محل زندگی

وضعیت Vehicle .

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

VisualTrafficReportPolynerendering

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

فیلدها
road_ stretch[]	RoadStretch اختیاری. امتداد جاده ای که باید در امتداد پلی خط ارائه شود. کشش ها تضمین می شوند که با هم همپوشانی نکنند و لزوماً مسیر کامل را طی نمی کنند. در صورت عدم وجود کشش جاده ای به سبک ، مشتری باید پیش فرض مسیر را اعمال کند.

پیشرو

یک کشش جاده ای که باید ارائه شود.

فیلدها
style	Style مورد نیاز. سبک برای اعمال
offset_ meters	int32 مورد نیاز. این سبک باید بین [offset_meters, offset_meters + length_meters) اعمال شود.
length_ meters	int32 مورد نیاز. طول مسیر که در آن سبک استفاده شود.

سبک

سبک ترافیک ، نشانگر سرعت ترافیک است.

Enums
STYLE_UNSPECIFIED	بدون سبکی انتخاب نشده است.
SLOWER_TRAFFIC	ترافیک در حال کند شدن است.
TRAFFIC_JAM	یک ترافیک وجود دارد.

نقطه راه

نقاط واسطه ای را در طول مسیر برای یک VehicleMatch در یک SearchVehiclesResponse توصیف می کند. این مفهوم در تمام نقاط پایانی دیگر به عنوان یک TripWaypoint نشان داده شده است.

فیلدها
lat_ lng	LatLng محل این ایستگاه راه.
eta	Timestamp زمان تخمینی که وسیله نقلیه به این نقطه راه می رسد.

نقطه WaypointType

نوع Waypoint.

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