Package maps.fleetengine.v1

شاخص

تریپ سرویس

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

CreateTrip

rpc CreateTrip( CreateTripRequest ) returns ( Trip )

یک سفر در Fleet Engine ایجاد می کند و سفر جدید را برمی گرداند.

DeleteTrip

rpc DeleteTrip( DeleteTripRequest ) returns ( Empty )

یک سفر را حذف می کند.

اگر سفر فعال باشد و به وسیله نقلیه اختصاص داده شده باشد، FAILED_PRECONDITION برمی‌گردد.

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

تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند.

Delete Vehicle

rpc DeleteVehicle( DeleteVehicleRequest ) returns ( Empty )

یک وسیله نقلیه را از موتور ناوگان حذف می کند.

اگر وسیله نقلیه سفرهای فعال داشته باشد، FAILED_PRECONDITION برمی‌گرداند. به آن اختصاص داده شده است.

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

تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند.

DeleteTripRequest

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

فیلدها
header

RequestHeader

اختیاری. هدر درخواست استاندارد Fleet Engine.

name

string

مورد نیاز. باید در قالب providers/{provider}/trips/{trip} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.

DeleteVehicleRequest

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

فیلدها
header

RequestHeader

اختیاری. هدر درخواست استاندارد Fleet Engine.

name

string

مورد نیاز. باید در قالب providers/{provider}/vehicles/{vehicle} باشد. {provider} باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می کند، عضو آن است.

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

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

فیلدها
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 است_ 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 اصلاح شده است.

توجه: این قسمت فقط برای استفاده توسط راننده 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

آخرین مکان گزارش شده وسیله نقلیه.

past_locations[]

VehicleLocation

فقط ورودی مکانهایی که این وسیله نقلیه در گذشته بوده است که هنوز به موتور ناوگان گزارش نشده است. این مورد در UpdateVehicleRequest برای ضبط مکان هایی که قبلاً قادر به ارسال به سرور نبودند ، استفاده می شود. به طور معمول این اتفاق می افتد که وسیله نقلیه اتصال به اینترنت نداشته باشد.

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 خالی باشد ، مقدار نامشخص است. اگر همه طرفین از همان ساعت استفاده می کنند ، این مقدار باید با eta_to_first_waypoint current_time داشته باشد.

هنگام به روزرسانی یک وسیله نقلیه ، 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 .

ordered_by

VehicleMatchOrder

سفارش درخواست شده برای مرتب سازی مسابقات وسیله نقلیه. معادل requested_ordered_by .

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

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

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 ایستگاه های راه برای مقصد متوسط ​​در یک سفر چند خوابه.