Package maps.fleetengine.v1

شاخص

تریپ سرویس

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

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

این فیلد از سفارش دستی ایستگاه های بین راه برای سفر پشتیبانی می کند. این شامل تمام ایستگاه های بین راهی برای وسیله نقلیه تعیین شده، و همچنین ایستگاه های حمل و نقل و تحویل برای این سفر است. اگر سفر به وسیله نقلیه اختصاص داده نشده باشد، Fleet Engine این قسمت را نادیده می گیرد. به دلایل حفظ حریم خصوصی، این قسمت فقط توسط سرور در تماس‌های UpdateTrip و CreateTrip پر می‌شود، نه در تماس‌های GetTrip .

route[]

LatLng

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

current_route_segment

string

فقط خروجی یک مسیر رمزگذاری شده به ایستگاه بعدی.

توجه: این فیلد فقط برای استفاده توسط Driver SDK و Consumer SDK در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نمی شود.

current_route_segment_version

Timestamp

فقط خروجی آخرین باری که مسیر اصلاح شده را نشان می دهد.

توجه: این فیلد فقط برای استفاده توسط Driver SDK و Consumer SDK در نظر گرفته شده است.

current_route_segment_traffic

ConsumableTrafficPolyline

فقط خروجی شرایط ترافیکی در امتداد current_route_segment را در زمانی که در دسترس هستند نشان می دهد.

توجه: این فیلد فقط برای استفاده توسط Driver SDK و Consumer SDK در نظر گرفته شده است.

current_route_segment_traffic_version

Timestamp

فقط خروجی آخرین باری را نشان می دهد که current_route_segment_traffic تغییر کرده است.

توجه: این فیلد فقط برای استفاده توسط Driver SDK و Consumer 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 . اگر سفر به وسیله نقلیه اختصاص داده نشده باشد، یا سفر غیرفعال (تکمیل یا لغو شده باشد)، مقدار مشخص نیست.

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 را به بخش فعلی_روت منتقل کرد یا خیر. اگر last_location یا current_route_segment وجود نداشته باشد، نادرست است. توسط Fleet Engine محاسبه شده است. هر گونه به روز رسانی از مشتریان نادیده گرفته می شود.

view

TripView

زیر مجموعه فیلدهای Trip که پر می شوند و نحوه تفسیر آنها.

وضعیت سفر

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

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

TripType

نوع سفر.

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

TripView

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

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

TripWaypoint

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

فیلدها
location

TerminalLocation

محل این ایستگاه بین راهی.

trip_id

string

سفر مرتبط با این ایستگاه.

waypoint_type

WaypointType

نقشی که این ایستگاه بین راهی در این سفر ایفا می کند، مانند پیکاپ یا تخلیه.

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

مسیر رمزگذاری شده از ایستگاه بین راه قبلی به نقطه بین راه فعلی.

توجه: این فیلد فقط برای استفاده توسط Driver SDK و Consumer SDK در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نمی شود.

traffic_to_waypoint

ConsumableTrafficPolyline

شرایط ترافیکی مسیر منتهی به این ایستگاه. توجه داشته باشید که ترافیک فقط برای مشتریان Google Map Platform Rides and Deliveries Solution در دسترس است.

distance_meters

Int32Value

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

eta

Timestamp

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

duration

Duration

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

UpdateTripRequest

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

فیلدها
header

RequestHeader

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

name

string

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

trip

Trip

مورد نیاز. سفر مرتبط با به‌روزرسانی.

فیلدهای زیر توسط Fleet Engine نگهداری می شوند. آنها را با استفاده از 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 تصویب شده باید با نسخه Fleet Engine سازگار باشد. اگر اینطور نباشد، درخواست با شکست مواجه می شود.

update_mask

FieldMask

مورد نیاز. ماسک فیلد که نشان می دهد کدام فیلدها در Trip باید به روز شوند. update_mask باید حداقل یک فیلد داشته باشد.

UpdateVehicleAttributesRequest

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

فیلدها
header

RequestHeader

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

name

string

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

attributes[]

VehicleAttribute

مورد نیاز. ویژگی های خودرو برای به روز رسانی. ویژگی های نامبرده تغییر یا حذف نمی شوند.

UpdateVehicleAttributesResponse

پیام پاسخ UpdateVehicleAttributes .

فیلدها
attributes[]

VehicleAttribute

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

Update VehicleRequest

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

فیلدها
header

RequestHeader

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

name

string

مورد نیاز. باید در قالب providers/{provider}/vehicles/{vehicle} باشد. {provider} باید شناسه پروژه (به عنوان مثال، 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

منسوخ شده: به جای آن از Vehicle.waypoints استفاده کنید.

current_route_segment

string

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

توجه: این قسمت فقط برای استفاده توسط Driver SDK در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نمی شود.

current_route_segment_traffic

TrafficPolylineData

فقط ورودی Fleet Engine از این اطلاعات برای بهبود اشتراک گذاری سفر استفاده می کند. توجه: این قسمت فقط برای استفاده توسط Driver SDK در نظر گرفته شده است.

current_route_segment_version

Timestamp

فقط خروجی زمانی که current_route_segment تنظیم شد. می تواند توسط مشتری ذخیره شود و در درخواست های GetVehicle آینده برای جلوگیری از بازگشت مسیرهایی که تغییر نکرده اند، ارسال شود.

current_route_segment_end_point

TripWaypoint

نقطه ای که در آن current_route_segment به پایان می رسد. این می‌تواند توسط رانندگان در تماس‌های UpdateVehicle یا به‌عنوان یک ایستگاه راه کامل، یک نقطه بین LatLng یا به‌عنوان آخرین LatLng از current_route_segment ارائه شود. Fleet Engine پس از آن تمام تلاش خود را برای درون یابی به یک نقطه بین راه واقعی انجام می دهد اگر به طور کامل مشخص نشده باشد. این فیلد در تماس‌های 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 یک وسیله نقلیه انسانی که معمولاً در حال راه رفتن یا دویدن است و در مسیرهای عابر پیاده حرکت می کند.

VehicleAttribute

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

فیلدها
key

string

کلید ویژگی کلیدها ممکن است حاوی شخصیت روده بزرگ نباشند (:).

value

string

مقدار ویژگی

میدان اتحادیه vehicle_attribute_value . مقدار مشخصه می تواند از نوع رشته ای، bool یا دوگانه باشد. vehicle_attribute_value تنها می تواند یکی از موارد زیر باشد:
string_value

string

مقدار مشخصه را رشته ای تایپ کرد.

توجه: این همان فیلد value است که در نهایت منسوخ خواهد شد. برای ایجاد یا به روزرسانی روش ها ، از هر قسمت استفاده می شود ، اما استفاده از string_value به شدت توصیه می شود. اگر هر دو string_value و value تنظیم شوند ، باید یکسان باشند یا خطایی پرتاب شود. هر دو فیلد در پاسخ ها پر شده اند.

bool_value

bool

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

number_value

double

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

وسیله نقلیه

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

فیلدها
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

مهر زمانی مرتبط با مکان تکمیلی.

supplemental_location_sensor

LocationSensor

منبع مکان تکمیلی پیش فرض به CUSTOMER_SUPPLIED_LOCATION .

supplemental_location_accuracy

DoubleValue

دقت در supplemental_location به عنوان شعاع ، در متر.

road_snapped
(deprecated)

bool

deprecated: به جای آن از is_road_snapped استفاده کنید.

وسیله نقلیه

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

فیلدها
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

اختیاری. امتداد جاده ای که باید در امتداد چند خط ارائه شود. کشش ها تضمین می شوند که با هم همپوشانی نکنند و لزوماً مسیر کامل را طی نمی کنند.

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

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