شاخص
-
TripService
(رابط) -
VehicleService
(رابط) -
BatteryInfo
(پیام) -
BatteryStatus
(عدد) -
BillingPlatformIdentifier
(enum) -
ConsumableTrafficPolyline
(پیام) -
CreateTripRequest
(پیام) -
CreateVehicleRequest
(پیام) -
DeviceSettings
(پیام) -
GetTripRequest
(پیام) -
GetVehicleRequest
(پیام) -
LicensePlate
(پیام) -
ListVehiclesRequest
(پیام) -
ListVehiclesResponse
(پیام) -
LocationPowerSaveMode
(enum) -
LocationSensor
(تعدادی) -
NavigationStatus
(enum) -
PolylineFormatType
(enum) -
PowerSource
(enum) -
ReportBillableTripRequest
(پیام) -
ReportBillableTripRequest.SolutionType
(enum) -
RequestHeader
(پیام) -
RequestHeader.Platform
(enum) -
RequestHeader.SdkType
(enum) -
SearchTripsRequest
(پیام) -
SearchTripsResponse
(پیام) -
SearchVehiclesRequest
(پیام) -
SearchVehiclesRequest.CurrentTripsPresent
(enum) -
SearchVehiclesRequest.VehicleMatchOrder
(enum) -
SearchVehiclesResponse
(پیام) -
SpeedReadingInterval
(پیام) -
SpeedReadingInterval.Speed
(enum) -
StopLocation
(پیام) -
TerminalLocation
(پیام) -
TerminalPointId
(پیام) (منسوخ شده) -
TrafficPolylineData
(پیام) -
Trip
(پیام) -
TripStatus
(enum) -
TripType
(enum) -
TripView
(enum) -
TripWaypoint
(پیام) -
UpdateTripRequest
(پیام) -
UpdateVehicleAttributesRequest
(پیام) -
UpdateVehicleAttributesResponse
(پیام) -
UpdateVehicleRequest
(پیام) -
Vehicle
(پیام) -
Vehicle.VehicleType
(پیام) -
Vehicle.VehicleType.Category
(تعدادی) -
VehicleAttribute
(پیام) -
VehicleAttributeList
(پیام) -
VehicleLocation
(پیام) -
VehicleMatch
(پیام) -
VehicleMatch.VehicleMatchType
(enum) -
VehicleState
(تعدادی) -
VisualTrafficReportPolylineRendering
(پیام) -
VisualTrafficReportPolylineRendering.RoadStretch
(پیام) -
VisualTrafficReportPolylineRendering.RoadStretch.Style
(enum) -
Waypoint
(پیام) -
WaypointType
(enum)
تریپ سرویس
خدمات مدیریت سفر.
CreateTrip |
---|
یک سفر در Fleet Engine ایجاد می کند و سفر جدید را برمی گرداند. |
GetTrip |
---|
در مورد یک سفر اطلاعات کسب کنید. |
ReportBillableTrip |
---|
گزارش استفاده از سفر قابل پرداخت |
SearchTrips |
---|
تمام سفرها را برای یک وسیله نقلیه خاص دریافت کنید. |
UpdateTrip |
---|
داده های سفر را به روز می کند. |
سرویس خودرو
خدمات مدیریت خودرو.
Create Vehicle |
---|
یک وسیله نقلیه جدید مرتبط با یک ارائهدهنده سهم یا تحویل بر اساس تقاضا را نشان میدهد. هر هنگام ایجاد یک
هنگام ایجاد یک
تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند. |
GetVehicle |
---|
یک وسیله نقلیه را از موتور ناوگان برمیگرداند. |
ListVehicles |
---|
فهرست صفحه بندی شده ای از وسایل نقلیه مرتبط با ارائه دهنده ای را برمی گرداند که با گزینه های درخواست مطابقت دارند. |
جستجوی وسایل نقلیه |
---|
فهرستی از وسایل نقلیه را برمیگرداند که با گزینههای درخواست مطابقت دارند. |
Update Vehicle |
---|
داده های به روز شده خودرو را در Fleet Engine می نویسد. هنگام بهروزرسانی یک
اگر فیلد |
UpdateVehicleAttributes |
---|
تا حدی ویژگی های خودرو را به روز می کند. فقط ویژگی های ذکر شده در درخواست به روز می شوند، سایر ویژگی ها تغییر نخواهند کرد. توجه: این در |
BatteryInfo
اطلاعاتی در مورد باتری دستگاه
فیلدها | |
---|---|
battery_status | وضعیت باتری، پر بودن یا شارژ شدن و غیره |
power_source | وضعیت منبع تغذیه باتری |
battery_percentage | درصد باتری فعلی [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[] | سرعت ترافیک در طول مسیر از ایستگاه قبلی تا ایستگاه فعلی. |
encoded_path_to_waypoint | مسیری که راننده از ایستگاه قبلی تا ایستگاه فعلی طی می کند. این مسیر دارای نشانههایی در خود است، بنابراین مشتریان میتوانند نشانگرهای ترافیکی را در طول مسیر نشان دهند (به |
CreateTripRequest
پیام درخواست CreateTrip.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
parent | مورد نیاز. باید در قالب |
trip_id | مورد نیاز. شناسه منحصر به فرد سفر مشروط به محدودیت های زیر:
|
trip | مورد نیاز. نهاد سفر برای ایجاد. هنگام ایجاد یک سفر، فیلدهای زیر مورد نیاز است:
در صورت ارائه فیلدهای زیر استفاده می شود:
همه فیلدهای سفر دیگر نادیده گرفته می شوند. به عنوان مثال، همه سفرها با یک فقط سفرهای هنگامی که هنگامی که از فیلدهای |
CreateVehicleRequest
پیام درخواست CreateVehicle
.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
parent | مورد نیاز. باید در قالب |
vehicle_id | مورد نیاز. شناسه منحصر به فرد خودرو مشروط به محدودیت های زیر:
|
vehicle | مورد نیاز. نهاد وسیله نقلیه برای ایجاد. هنگام ایجاد یک وسیله نقلیه، فیلدهای زیر مورد نیاز است:
هنگام ایجاد یک وسیله نقلیه، فیلدهای زیر نادیده گرفته می شوند:
تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند. |
تنظیمات دستگاه
اطلاعات مربوط به تنظیمات مختلف در دستگاه تلفن همراه.
فیلدها | |
---|---|
location_power_save_mode | وقتی «بهینهسازی باتری» روشن است، ویژگیهای مکان چگونه تنظیم میشوند تا در دستگاه رفتار کنند. |
is_power_save_mode | اینکه آیا دستگاه در حال حاضر در حالت صرفه جویی در مصرف انرژی است یا خیر. |
is_interactive | اینکه آیا دستگاه در حالت تعاملی است. |
battery_info | اطلاعاتی در مورد وضعیت باتری |
GetTripRequest
پیام درخواست GetTrip.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
name | مورد نیاز. باید در قالب |
view | زیر مجموعه فیلدهای Trip که باید برگردانده شوند و تفسیر آنها. |
current_route_segment_version | نشاندهنده حداقل مهر زمانی (انحصاری) است که دادههای |
remaining_waypoints_version | حداقل مهر زمانی (انحصاری) که |
route_format_type | قالب مسیر فعلی برگشتی، |
current_route_segment_traffic_version | حداقل مهر زمانی (انحصاری) که |
remaining_waypoints_route_version | حداقل مهر زمانی (انحصاری) را نشان میدهد که دادههای |
GetVehicleRequest
پیام درخواست GetVehicle
.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
name | مورد نیاز. باید در قالب |
current_route_segment_version | حداقل مهر زمانی (انحصاری) که |
waypoints_version | حداقل مهر زمانی (انحصاری) که دادههای |
پلاک مجوز
اطلاعات پلاک خودرو برای جلوگیری از ذخیره اطلاعات قابل شناسایی شخصی، فقط حداقل اطلاعات مربوط به پلاک به عنوان بخشی از نهاد ذخیره می شود.
فیلدها | |
---|---|
country_code | مورد نیاز. کد کشور/منطقه CLDR. به عنوان مثال، |
last_character | آخرین رقم پلاک یا "-1" برای نشان دادن هیچ عددی در پلاک وجود ندارد.
|
ListVehiclesRequest
پیام درخواست ListVehicles
.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
parent | مورد نیاز. باید در قالب |
page_size | حداکثر تعداد وسایل نقلیه برای بازگشت. مقدار پیش فرض: 100. |
page_token | مقدار |
minimum_capacity | حداقل ظرفیت مورد نیاز وسیله نقلیه را مشخص می کند. تمام وسایل نقلیه برگشتی دارای |
trip_types[] | پاسخ به وسایل نقلیه ای را که حداقل یکی از انواع سفرهای مشخص شده را پشتیبانی می کنند، محدود می کند. |
maximum_staleness | پاسخ به خودروهایی را که در مدت زمان مشخص شده بهروزرسانیهای مکان را به Fleet Engine ارسال کردهاند، محدود میکند. وسایل نقلیه ثابتی که هنوز مکان خود را مخابره می کنند کهنه در نظر گرفته نمی شوند. در صورت وجود، باید مدت زمان مثبت معتبر باشد. |
vehicle_type_categories[] | مورد نیاز. پاسخ به وسایل نقلیه با یکی از دسته بندی های نوع مشخص شده را محدود می کند. |
required_attributes[] | تماس گیرندگان می توانند عملیات منطقی پیچیده ای را با استفاده از هر ترکیبی از فیلدهای
پاسخ به وسایل نقلیه با ویژگی های مشخص شده را محدود می کند. این فیلد یک عملیات ربط/AND است. حداکثر 50 مورد_ویژگی مجاز است. این با حداکثر تعداد مشخصه های مجاز در یک وسیله نقلیه مطابقت دارد. هر رشته تکرار شده باید با فرمت "key:value" باشد. |
required_one_of_attributes[] | پاسخ به وسایل نقلیه با حداقل یکی از ویژگی های مشخص شده در هر |
required_one_of_attribute_sets[] | مشابه
پاسخ را به وسایل نقلیه ای محدود می کند که با تمام ویژگی های یک |
vehicle_state | پاسخ را به خودروهایی که دارای این وضعیت خودرو هستند محدود می کند. |
on_trip_only | فقط وسایل نقلیه با سفر(های) فعلی را برگردانید. |
filter | اختیاری. یک درخواست فیلتر برای اعمال در هنگام فهرست کردن وسایل نقلیه. برای نمونه هایی از نحو فیلتر http://aip.dev/160 را ببینید. این فیلد بهمنظور جایگزینی فیلدهای این فیلتر بهعنوان یک AND با محدودیتهای دیگر، مانند توجه داشته باشید که تنها جستارهای پشتیبانی شده مربوط به ویژگی های وسیله نقلیه هستند (به عنوان مثال، همچنین، تمام ویژگی ها به عنوان رشته ذخیره می شوند، بنابراین تنها مقایسه های پشتیبانی شده در برابر ویژگی ها، مقایسه رشته ها هستند. به منظور مقایسه با مقادیر یا مقادیر بولی، مقادیر باید به صراحت نقل قول شوند تا به عنوان رشته در نظر گرفته شوند (به عنوان مثال، |
viewport | اختیاری. فیلتری که وسایل نقلیه بازگشتی را محدود به خودروهایی میکند که آخرین مکان شناختهشدهشان در ناحیه مستطیلی تعریفشده توسط viewport بوده است. |
ListVehiclesResponse
پیام پاسخ ListVehicles
.
فیلدها | |
---|---|
vehicles[] | وسایل نقلیه مطابق با معیارهای موجود در درخواست حداکثر تعداد خودروهای برگشتی با فیلد |
next_page_token | توکن برای بازیابی صفحه بعدی وسایل نقلیه، یا اگر خودروهای دیگری وجود نداشتند که معیارهای درخواست را برآورده کنند خالی کنید. |
total_size | مورد نیاز. تعداد کل وسایل نقلیه مطابق با معیارهای درخواست در تمام صفحات. |
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 | ارائه دهنده مکان در سیستم عامل های اپل. |
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 | مورد نیاز. باید در قالب |
country_code | مورد نیاز. کد کشور دو حرفی کشور محل سفر. قیمت با توجه به کد کشور تعریف می شود. |
platform | بستری که درخواست بر اساس آن صادر شده است. |
related_ids[] | شناسه هایی که مستقیماً با سفر گزارش شده مرتبط هستند. اینها معمولاً شناسههایی (مثلاً شناسههای جلسه) مربوط به عملیات پیشرزرو هستند که قبل از در دسترس بودن شناسه سفر انجام شدهاند. تعداد |
solution_type | نوع راه حل محصول GMP (به عنوان مثال، |
نوع راه حل
انتخابگر برای انواع راه حل های مختلف یک سفر گزارش شده.
Enums | |
---|---|
SOLUTION_TYPE_UNSPECIFIED | مقدار پیش فرض برای سازگاری با عقب، API به طور پیش فرض از ON_DEMAND_RIDESHARING_AND_DELIVERIES استفاده می کند که اولین نوع راه حل پشتیبانی شده است. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES | راه حل این است که بر حسب تقاضا سفری به اشتراک گذاشته شود. |
RequestHeader
یک RequestHeader حاوی فیلدهای مشترک برای تمام درخواستهای Fleet Engine RPC است.
فیلدها | |
---|---|
language_code | کد زبان BCP-47، مانند en-US یا sr-Latn. برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. اگر هیچ یک مشخص نشده باشد، پاسخ ممکن است به هر زبانی باشد و در صورت وجود چنین نامی، ترجیحاً انگلیسی باشد. مثال مقدار فیلد: |
region_code | مورد نیاز. کد منطقه CLDR منطقه ای که درخواست از آنجا منشاء می گیرد. مثال مقدار فیلد: |
sdk_version | نسخه SDK تماس، در صورت وجود. قالب نسخه "major.minor.patch" است، به عنوان مثال: |
os_version | نسخه سیستم عاملی که SDK فراخوانی روی آن اجرا می شود. نمونه های مقدار فیلد: |
device_model | مدل دستگاهی که SDK فراخوانی روی آن اجرا میشود. نمونه های مقدار فیلد: |
sdk_type | نوع SDK ارسال درخواست. |
maps_sdk_version | نسخه MapSDK که در صورت وجود، SDK فراخوانی به آن بستگی دارد. قالب نسخه "major.minor.patch" است، به عنوان مثال: |
nav_sdk_version | نسخه NavSDK که در صورت وجود، SDK فراخوانی به آن بستگی دارد. قالب نسخه "major.minor.patch" است، به عنوان مثال: |
platform | پلتفرم SDK فراخوانی. |
manufacturer | سازنده دستگاه Android از SDK تماس گیرنده، فقط برای SDK های Android قابل اجرا است. مثال مقدار فیلد: |
android_api_level | سطح Android API SDK تماس، فقط برای Android SDK قابل اجرا است. مثال مقدار فیلد: |
trace_id | شناسه اختیاری که می تواند برای اهداف ورود به سیستم به منظور شناسایی درخواست ارائه شود. |
پلت فرم
پلت فرم فراخوانی 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 | هدر درخواست استاندارد Fleet Engine. |
parent | مورد نیاز. باید در قالب |
vehicle_id | وسیله نقلیه مرتبط با سفرهای موجود در درخواست. اگر مشخص نشده باشد، سفرهای برگشتی شامل موارد زیر نیست:
|
active_trips_only | اگر روی true تنظیم شود، پاسخ شامل سفرهایی می شود که بر مسیر راننده تأثیر می گذارد. |
page_size | اگر تنظیم نشود، سرور تعداد نتایجی را که باید بازگردانده شود، تعیین می کند. |
page_token | این را روی مقداری تنظیم کنید که قبلاً در |
minimum_staleness | اگر مشخص شده باشد، سفرهایی را که بعد از زمان بهروزرسانی نشدهاند را برمیگرداند |
SearchTripsResponse
پیام پاسخ SearchTrips.
فیلدها | |
---|---|
trips[] | لیست سفرها برای وسیله نقلیه درخواستی. |
next_page_token | این نشانه را در SearchTripsRequest به صفحه نتایج فهرست ارسال کنید. API در هر تماس فهرست سفر را برمیگرداند و زمانی که نتیجه دیگری باقی نماند، فهرست سفر خالی است. |
Search Vehicles Request
پیام درخواست SearchVehicles
.
فیلدها | |
---|---|
header | هدر درخواست استاندارد Fleet Engine. |
parent | مورد نیاز. باید در قالب |
pickup_point | مورد نیاز. نقطه تحویل برای جستجو در نزدیکی. |
dropoff_point | محل خروج مورد نظر مشتری اگر |
pickup_radius_meters | مورد نیاز. شعاع جستجوی وسیله نقلیه را در اطراف نقطه وانت تعریف می کند. فقط وسایل نقلیه در شعاع جستجو بازگردانده خواهند شد. مقدار باید بین 400 تا 10000 متر (شامل) باشد. |
count | مورد نیاز. حداکثر تعداد وسایل نقلیه برای بازگشت را مشخص می کند. مقدار باید بین 1 تا 50 باشد (شامل). |
minimum_capacity | مورد نیاز. تعداد مسافرانی که برای یک سفر در نظر گرفته شده اند را مشخص می کند. مقدار باید بزرگتر یا مساوی یک باشد. راننده در مقدار ظرفیت در نظر گرفته نمی شود. |
trip_types[] | مورد نیاز. نشان دهنده نوع سفر پیشنهادی است. باید دقیقاً یک نوع را شامل شود. |
maximum_staleness | جستجو را فقط به وسایل نقلیهای محدود میکند که در مدت زمان مشخص شده بهروزرسانیهای مکان را به Fleet Engine ارسال کردهاند. وسایل نقلیه ثابتی که هنوز مکان خود را مخابره می کنند کهنه در نظر گرفته نمی شوند. اگر این فیلد تنظیم نشده باشد، سرور از پنج دقیقه به عنوان مقدار پیش فرض استفاده می کند. |
vehicle_types[] | مورد نیاز. جستجو را به خودروهایی با یکی از انواع مشخص شده محدود می کند. حداقل یک نوع وسیله نقلیه باید مشخص شود. انواع خودرو با دسته |
required_attributes[] | تماس گیرندگان می توانند عملیات منطقی پیچیده ای را با استفاده از هر ترکیبی از فیلدهای
جستجو را فقط به خودروهایی با ویژگیهای مشخص شده محدود میکند. این فیلد یک عملیات ربط/AND است. حداکثر 50 مورد_ویژگی مجاز است. این با حداکثر تعداد مشخصه های مجاز در یک وسیله نقلیه مطابقت دارد. |
required_one_of_attributes[] | جستجو را فقط به آن دسته از وسایل نقلیه با حداقل یکی از ویژگی های مشخص شده در هر |
required_one_of_attribute_sets[] | مشابه
جستجو را فقط به آن دسته از وسایل نقلیه با تمام ویژگیهای یک |
order_by | مورد نیاز. معیار سفارش مورد نظر را برای نتایج مشخص می کند. |
include_back_to_back | این نشان می دهد که آیا وسایل نقلیه با یک سفر فعال واجد شرایط این جستجو هستند یا خیر. این فیلد فقط زمانی استفاده می شود که مقدار پیش فرض |
trip_id | نشان دهنده سفر مرتبط با این |
current_trips_present | این نشان می دهد که آیا وسایل نقلیه با سفرهای فعال واجد شرایط این جستجو هستند یا خیر. اگر |
filter | اختیاری. یک درخواست فیلتر برای اعمال هنگام جستجوی وسایل نقلیه. برای نمونه هایی از نحو فیلتر http://aip.dev/160 را ببینید. این فیلد بهمنظور جایگزینی فیلدهای این فیلتر بهعنوان یک بند AND با محدودیتهای دیگر مانند توجه داشته باشید که تنها جستارهای پشتیبانی شده مربوط به ویژگی های وسیله نقلیه هستند (به عنوان مثال، همچنین، تمام ویژگی ها به عنوان رشته ذخیره می شوند، بنابراین تنها مقایسه های پشتیبانی شده در برابر ویژگی ها، مقایسه رشته ها هستند. به منظور مقایسه با مقادیر یا مقادیر بولی، مقادیر باید به صراحت نقل قول شوند تا به عنوان رشته در نظر گرفته شوند (به عنوان مثال، |
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[] | فهرست خودروهایی که با معیارهای |
SpeedReading Interval
نشانگر تراکم ترافیک در یک بخش پیوسته از یک مسیر. با توجه به مسیری با نقاط P_0، P_1، ...، P_N (شاخص مبتنی بر صفر)، SpeedReadingInterval یک بازه را تعریف میکند و ترافیک آن را با استفاده از دستههای زیر توصیف میکند.
فیلدها | |
---|---|
start_polyline_point_index | شاخص شروع این بازه در مسیر. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد. |
end_polyline_point_index | شاخص پایانی این بازه در مسیر. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد. |
speed | سرعت ترافیک در این بازه. |
سرعت
طبقه بندی سرعت چند خط بر اساس داده های ترافیک.
Enums | |
---|---|
SPEED_UNSPECIFIED | مقدار پیش فرض این مقدار استفاده نشده است. |
NORMAL | سرعت معمولی، هیچ کاهش سرعت تشخیص داده نمی شود. |
SLOW | کاهش سرعت شناسایی شد، اما ترافیک ایجاد نشد. |
TRAFFIC_JAM | ترافیک شناسایی شد |
StopLocation
مکان واقعی که در آن توقف (انتقال / خروج) اتفاق افتاده است.
فیلدها | |
---|---|
point | مورد نیاز. مکان واقعی را نشان می دهد. |
timestamp | زمان وقوع توقف را نشان می دهد. |
stop_time | فقط ورودی منسوخ شده است. از قسمت مهر زمان استفاده کنید. |
TerminalLocation
موقعیت یک نقطه راه را توصیف می کند.
فیلدها | |
---|---|
point | مورد نیاز. نشان دهنده محل یک ایستگاه بین راهی سفر است. |
terminal_point_id | منسوخ شده: به جای آن فیلد |
access_point_id | منسوخ شده: به جای آن فیلد |
trip_id | منسوخ شده است. |
terminal_location_type | منسوخ شده: |
TerminalPointId
منسوخ شده: TerminalPoints دیگر در Fleet Engine پشتیبانی نمی شود. به جای آن از TerminalLocation.point
استفاده کنید.
فیلدها | |
---|---|
value | منسوخ شده است. |
Id فیلد اتحادیه منسوخ شده است. Id می تواند تنها یکی از موارد زیر باشد: | |
place_id | منسوخ شده است. |
generated_id | منسوخ شده است. |
TrafficPolylineData
شرایط ترافیکی در مسیر مورد انتظار خودرو.
فیلدها | |
---|---|
traffic_rendering | یک نمایش چند خطی از سرعت ترافیک برای همه مناطق در طول یک مسیر از سفر مشتری. |
سفر
فراداده سفر
فیلدها | |
---|---|
name | فقط خروجی در قالب "provider/{provider}/trips/{trip}" |
vehicle_id | شناسه وسیله نقلیه ای که این سفر را انجام می دهد. |
trip_status | وضعیت فعلی سفر |
trip_type | نوع سفر. |
pickup_point | مکانی که مشتری نشان می دهد که آنها را تحویل می گیرند. |
actual_pickup_point | فقط ورودی مکان واقعی زمان و مکان تحویل مشتری این فیلد برای ارائهدهنده بازخورد در مورد اطلاعات دریافت واقعی است. |
actual_pickup_arrival_point | فقط ورودی زمان و مکان واقعی ورود راننده به نقطه وانت. این فیلد برای ارائهدهنده است تا در مورد اطلاعات ورود واقعی در نقطه تحویل بازخورد ارائه دهد. |
pickup_time | فقط خروجی یا زمان تخمینی آینده که سوار(ها) سوار می شوند، یا زمان واقعی که سوار می شوند. |
intermediate_destinations[] | توقف های میانی به منظور درخواست سفر (علاوه بر تحویل و تحویل). در ابتدا این برای سفرهای مشترک پشتیبانی نخواهد شد. |
intermediate_destinations_version | آخرین باری را که |
intermediate_destination_index | هنگامی که |
actual_intermediate_destination_arrival_points[] | فقط ورودی زمان و مکان واقعی ورود راننده به یک مقصد میانی. این فیلد برای ارائهدهنده ارائه بازخورد در مورد اطلاعات ورود واقعی به مقصدهای میانی است. |
actual_intermediate_destinations[] | فقط ورودی زمان و مکان واقعی زمانی و مکانی که مشتری از یک مقصد میانی تحویل گرفته شده است. این فیلد برای ارائهدهنده است تا بازخوردی درباره اطلاعات دریافت واقعی در مقاصد میانی ارائه دهد. |
dropoff_point | مکانی که مشتری نشان می دهد که آنها را ترک خواهند کرد. |
actual_dropoff_point | فقط ورودی زمان و مکان واقعی زمان و مکان خروج مشتری. این فیلد برای ارائهدهنده است تا در مورد اطلاعات حذف واقعی بازخورد ارائه کند. |
dropoff_time | فقط خروجی یا زمان تخمین زده شده در آینده که سوار (ها) در مقصد نهایی از بین بروند ، یا زمان واقعی از بین رفتن آنها. |
remaining_waypoints[] | فقط خروجی مسیر کامل از مکان فعلی به نقطه سقوط ، شامل. این مسیر می تواند شامل نقاط راه از سفرهای دیگر باشد. |
vehicle_waypoints[] | این زمینه از سفارش دستی از ایستگاه های راه برای سفر پشتیبانی می کند. این شامل تمام ایستگاه های بین راهی برای وسیله نقلیه تعیین شده، و همچنین ایستگاه های حمل و نقل و تحویل برای این سفر است. اگر این سفر به وسیله نقلیه اختصاص نیافته باشد ، موتور ناوگان این میدان را نادیده می گیرد. به دلایل حریم خصوصی ، این قسمت فقط توسط سرور در تماس های |
route[] | فقط خروجی مسیر پیش بینی شده برای این سفر به اولین ورودی در uring_waypoints. توجه داشته باشید که اولین نقطه راه ممکن است متعلق به یک سفر متفاوت باشد. |
current_route_segment | فقط خروجی یک مسیر رمزگذاری شده به سمت مسیر بعدی. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است. |
current_route_segment_version | فقط خروجی نشان می دهد آخرین باری که مسیر اصلاح شده است. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. |
current_route_segment_traffic | فقط خروجی شرایط ترافیک را در طول توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. |
current_route_segment_traffic_version | فقط خروجی آخرین باری را نشان می دهد که توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. |
current_route_segment_end_point | فقط خروجی نقطه راه که در آن به پایان می رسد_ |
remaining_distance_meters | فقط خروجی فاصله رانندگی باقیمانده در قسمت |
eta_to_first_waypoint | فقط خروجی ETA به نقطه راه بعدی (اولین ورودی در قسمت |
remaining_time_to_first_waypoint | فقط خروجی مدت زمان بازگشت داده های سفر به زمان |
remaining_waypoints_version | فقط خروجی آخرین باری را نشان می دهد که |
remaining_waypoints_route_version | فقط خروجی آخرین باری را نشان می دهد |
number_of_passengers | تغییرناپذیر. تعداد مسافران در این سفر را نشان می دهد و راننده را شامل نمی شود. یک وسیله نقلیه باید ظرفیت موجود در یک پاسخ |
last_location | فقط خروجی آخرین مکان گزارش شده وسیله نقلیه را در طول مسیر نشان می دهد. |
last_location_snappable | فقط خروجی نشان می دهد که آیا |
view | زیر مجموعه زمینه های سفر که جمعیتی دارند و نحوه تفسیر آنها. |
سه گانه
وضعیت سفر نشان دهنده پیشرفت آن است.
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 | محل این ایستگاه راه. |
trip_id | سفر مرتبط با این نقطه. |
waypoint_type | نقش این Waypoint در این سفر مانند وانت یا رها کردن ایفا می کند. |
path_to_waypoint[] | مسیر از مسیر قبلی به سمت مسیر فعلی. تعریف نشده برای اولین نقطه در یک لیست. این قسمت فقط در صورت درخواست جمع می شود. |
encoded_path_to_waypoint | مسیر رمزگذاری شده از نقطه راه قبلی به نقطه راه فعلی. توجه: این قسمت فقط برای استفاده توسط راننده SDK و SDK مصرف کننده در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است. |
traffic_to_waypoint | شرایط ترافیکی در طول مسیر به این نقطه. توجه داشته باشید که ترافیک فقط برای Google Map Platform Rides و Deliveries Solution مشتریان در دسترس است. |
distance_meters | فاصله مسیر از نقطه راه قبلی تا نقطه راه فعلی. تعریف نشده برای اولین نقطه در یک لیست. |
eta | زمان تخمینی ورود در این نقطه. تعریف نشده برای اولین نقطه در یک لیست. |
duration | زمان سفر از مسیر قبلی به این نقطه. تعریف نشده برای اولین نقطه در یک لیست. |
به روزرسانی
پیام درخواست UpdateTrip.
فیلدها | |
---|---|
header | هدر درخواست موتور ناوگان استاندارد. |
name | مورد نیاز. باید در |
trip | مورد نیاز. سفر مرتبط با بروزرسانی. زمینه های زیر توسط موتور ناوگان نگهداری می شود. آنها را با استفاده از Trip.update به روز نکنید.
هنگامی که هنگامی که برای جلوگیری از شرط مسابقه برای سفرهای با مقصد های متعدد ، باید هنگام بروزرسانی وضعیت سفر به |
update_mask | مورد نیاز. ماسک میدانی که نشان می دهد کدام قسمت در سفر برای به روزرسانی است. |
UpdateveHicLeatTributesRequest
پیام درخواست UpdateVehicleAttributes
.
فیلدها | |
---|---|
header | هدر درخواست موتور ناوگان استاندارد. |
name | مورد نیاز. باید در |
attributes[] | مورد نیاز. ویژگی های وسیله نقلیه برای به روزرسانی. ویژگی های غیرقابل تغییر تغییر نکرده یا حذف نمی شوند. |
به روزرسانی
پیام پاسخ UpdateVehicleAttributes
.
فیلدها | |
---|---|
attributes[] | مورد نیاز. لیست کامل به روز شده از ویژگی های وسیله نقلیه ، از جمله ویژگی های جدید ، تغییر یافته و دست نخورده. |
Updatevehiclerequest
`پیام درخواست UpdateveHicle.
فیلدها | |
---|---|
header | هدر درخواست موتور ناوگان استاندارد. |
name | مورد نیاز. باید در |
vehicle | مورد نیاز. ارزش موجودیت
اگر قسمت به همین ترتیب ، قسمت |
update_mask | مورد نیاز. ماسک میدانی که نشان می دهد کدام قسمت از |
وسیله نقلیه
ابرداده وسیله نقلیه.
فیلدها | |
---|---|
name | فقط خروجی نام منحصر به فرد این وسیله نقلیه. قالب |
vehicle_state | حالت وسیله نقلیه |
supported_trip_types[] | انواع سفر پشتیبانی شده توسط این وسیله نقلیه. |
current_trips[] | فقط خروجی لیست |
last_location | آخرین مکان گزارش شده وسیله نقلیه. |
maximum_capacity | تعداد کل سواران این وسیله نقلیه می تواند حمل کند. راننده در این مقدار در نظر گرفته نمی شود. این مقدار باید بیشتر از یا مساوی باشد. |
attributes[] | لیست ویژگی های وسیله نقلیه. یک وسیله نقلیه می تواند حداکثر 100 ویژگی داشته باشد و هر ویژگی باید یک کلید منحصر به فرد داشته باشد. |
vehicle_type | مورد نیاز. نوع این وسیله نقلیه می توان برای فیلتر کردن وسایل نقلیه در نتایج |
license_plate | اطلاعات پلاک برای وسیله نقلیه. |
route[] | deprecated: به جای آن |
current_route_segment | پلی خطی که مسیری را که برنامه درایور قصد دارد به سمت مسیر بعدی طی کند ، مشخص می کند. این لیست همچنین در توجه: این قسمت فقط برای استفاده توسط درایور SDK در نظر گرفته شده است. رمزگشایی هنوز پشتیبانی نشده است. |
current_route_segment_traffic | فقط ورودی موتور ناوگان از این اطلاعات برای بهبود اشتراک سفر استفاده می کند. توجه: این قسمت فقط برای استفاده توسط درایور SDK در نظر گرفته شده است. |
current_route_segment_version | فقط خروجی زمان تنظیم |
current_route_segment_end_point | نقطه راه که در آن به پایان می رسد_ |
remaining_distance_meters | فاصله رانندگی باقیمانده برای |
eta_to_first_waypoint | ETA به اولین ورودی در قسمت هنگام به روزرسانی یک وسیله نقلیه ، |
remaining_time_seconds | فقط ورودی زمان رانندگی باقیمانده برای هنگام به روزرسانی یک وسیله نقلیه ، |
waypoints[] | ایستگاه های راه باقی مانده به این وسیله نقلیه اختصاص داده شده است. |
waypoints_version | فقط خروجی آخرین باری که قسمت |
back_to_back_enabled | نشان می دهد که آیا راننده سفرهای برگشت به عقب را می پذیرد یا خیر. اگر |
navigation_status | وضعیت ناوبری وسیله نقلیه. |
device_settings | فقط ورودی اطلاعات مربوط به تنظیمات موجود در دستگاه تلفن همراه که توسط درایور استفاده می شود. |
نوع
نوع وسیله نقلیه
فیلدها | |
---|---|
category | دسته نوع وسیله نقلیه |
دسته بندی
دسته های نوع وسیله نقلیه
Enums | |
---|---|
UNKNOWN | پیش فرض ، برای دسته بندی وسایل نقلیه نامشخص یا ناشناخته استفاده می شود. |
AUTO | یک اتومبیل |
TAXI | هر وسیله نقلیه ای که به عنوان تاکسی عمل کند (به طور معمول دارای مجوز یا تنظیم) است. |
TRUCK | به طور کلی ، وسیله نقلیه با ظرفیت بزرگ ذخیره سازی. |
TWO_WHEELER | یک موتور سیکلت ، موتور سیکلت یا وسیله نقلیه دو چرخ دیگر |
BICYCLE | حمل و نقل با نیروی انسانی. |
PEDESTRIAN | یک حمل و نقل انسانی ، به طور معمول در حال پیاده روی یا دویدن ، در مسیرهای عابر پیاده سفر می کند. |
توزیع کننده
یک ویژگی وسیله نقلیه را به عنوان یک جفت ارزش کلید توصیف می کند. طول رشته "کلید: مقدار" نمی تواند از 256 کاراکتر تجاوز کند.
فیلدها | |
---|---|
key | کلید ویژگی کلیدها ممکن است حاوی شخصیت روده بزرگ نباشند (:). |
value | مقدار ویژگی |
Union Field vehicle_attribute_value . مقدار این ویژگی می تواند در رشته ، بول یا دو نوع باشد. vehicle_attribute_value فقط می تواند یکی از موارد زیر باشد: | |
string_value | مقدار ویژگی تایپ شده رشته. توجه: این یکسان با قسمت |
bool_value | مقدار ویژگی تایپ شده بولی. |
number_value | مقدار ویژگی Double Typed. |
وسیله نقلیه
مجموعه ای از لیست های لیست برای ویژگی های وسیله نقلیه.
فیلدها | |
---|---|
attributes[] | لیستی از ویژگی های این مجموعه. |
جابجایی وسایل نقلیه
مکان ، سرعت و عنوان یک وسیله نقلیه در یک نقطه از زمان.
فیلدها | |
---|---|
location | مکان وسیله نقلیه. هنگامی که به موتور ناوگان ارسال می شود ، مکان وسیله نقلیه یک مکان GPS است. هنگامی که آن را در یک پاسخ دریافت می کنید ، مکان وسیله نقلیه می تواند یک مکان GPS ، یک مکان تکمیلی یا مکان تخمین زده شده دیگر باشد. منبع در |
horizontal_accuracy | deprecated: به جای آن از |
latlng_accuracy | صحت |
heading | جهت وسیله نقلیه در درجه حرکت می کند. 0 نمایانگر شمال است. دامنه معتبر [0،360) است. |
bearing_accuracy | کاهش یافته: به جای آن از |
heading_accuracy | صحت |
altitude | ارتفاع در متر بالاتر از WGS84. |
vertical_accuracy | کاهش یافته: به جای آن از |
altitude_accuracy | دقت |
speed_kmph | سرعت وسیله نقلیه در کیلومتر در ساعت. کاهش یافته: به جای آن از |
speed | سرعت وسیله نقلیه در متر در ثانیه |
speed_accuracy | دقت |
update_time | زمان گزارش |
server_time | فقط خروجی زمانی که سرور اطلاعات مکان را دریافت کرد. |
location_sensor | ارائه دهنده داده های مکان (به عنوان مثال ، |
is_road_snapped | این که آیا |
is_gps_sensor_enabled | فقط ورودی نشان می دهد که آیا سنسور GPS در دستگاه تلفن همراه فعال است یا خیر. |
time_since_update | فقط ورودی زمان (در ثانیه) از آنجا که این مکان برای اولین بار به سرور ارسال شد. این برای اولین به روزرسانی صفر خواهد بود. اگر زمان ناشناخته باشد (به عنوان مثال ، وقتی برنامه دوباره شروع می شود) ، این مقدار به صفر می رسد. |
num_stale_updates | فقط ورودی مستهلک: اکنون سیگنال های دیگر برای تعیین اینکه آیا یک مکان بی نظیر است ، استفاده می شود. |
raw_location | محل کار وسیله نقلیه خام (از طریق راهپیمایی جاده ای). |
raw_location_time | Timestamp مرتبط با محل خام. |
raw_location_sensor | منبع محل خام. پیش فرض |
raw_location_accuracy | صحت |
supplemental_location | مکان تکمیلی ارائه شده توسط برنامه یکپارچه سازی. |
supplemental_location_time | Timestamp مرتبط با محل تکمیلی. |
supplemental_location_sensor | منبع محل تکمیلی. پیش فرض به |
supplemental_location_accuracy | دقت در |
road_snapped | deprecated: به جای آن از |
وسیله نقلیه
شامل وسیله نقلیه و تخمین های مربوط به وسیله نقلیه ای است که با نقاط سفرهای فعال برای SearchVehiclesRequest
Quest مطابقت دارد.
فیلدها | |
---|---|
vehicle | مورد نیاز. وسیله نقلیه ای که با درخواست مطابقت دارد. |
vehicle_pickup_eta | رانندگی وسیله نقلیه ETA به نقطه وانت مشخص شده در درخواست. مقدار خالی نشانگر عدم موفقیت در محاسبه ETA برای وسیله نقلیه است. اگر |
vehicle_pickup_distance_meters | فاصله از محل فعلی خودرو تا نقطه وانت مشخص شده در درخواست ، از جمله هر وانت متوسط یا نقاط قطره ای برای سفرهای موجود. این فاصله شامل فاصله محاسبه شده (مسیر) محاسبه شده ، به علاوه فاصله مستقیم خط بین نقطه پایان ناوبری و نقطه وانت درخواست شده است. (فاصله بین نقطه پایان ناوبری و نقطه وانت درخواست شده به طور معمول اندک است.) یک مقدار خالی نشانگر خطایی در محاسبه فاصله است. |
vehicle_pickup_straight_line_distance_meters | مورد نیاز. فاصله مستقیم بین وسیله نقلیه و نقطه وانت مشخص شده در درخواست. |
vehicle_dropoff_eta | رانندگی کامل وسیله نقلیه ETA به نقطه سقوط مشخص شده در درخواست. ETA شامل توقف در هر نقطه از ایستگاه های قبل از |
vehicle_pickup_to_dropoff_distance_meters | فاصله رانندگی وسیله نقلیه (در متر) از نقطه وانت تا نقطه افت مشخص شده در درخواست. فاصله فقط بین دو نقطه است و شامل مکان وسیله نقلیه یا هر نقطه دیگری نیست که باید قبل از بازدید وسیله نقلیه از نقطه وانت یا نقطه قطره بازدید شود. مقدار فقط در صورت مشخص شدن یک |
trip_type | مورد نیاز. نوع سفر درخواستی که برای محاسبه ETA در نقطه وانت استفاده شده است. |
vehicle_trips_waypoints[] | لیست سفارش داده شده از ایستگاه های راه استفاده شده برای محاسبه ETA. این لیست شامل موقعیت مکانی وسیله نقلیه ، وانت سفرهای فعال برای وسیله نقلیه و نقاط وانت ارائه شده در درخواست است. یک لیست خالی نشانگر عدم موفقیت در محاسبه ETA برای وسیله نقلیه است. |
vehicle_match_type | نوع مطابقت وسیله نقلیه. |
requested_ordered_by | سفارش درخواست شده برای مرتب سازی مسابقات وسیله نقلیه. |
ordered_by | ترتیب واقعی که برای این وسیله نقلیه استفاده شده است. به طور معمول این با قسمت "Order_By" از درخواست مطابقت دارد. با این حال ، در شرایط خاص مانند خطای سرور داخلی ، ممکن است از روش متفاوتی استفاده شود (مانند |
نوع وسایل نقلیه
نوع مطابقت وسیله نقلیه.
Enums | |
---|---|
UNKNOWN | نوع مسابقه ناشناخته وسیله نقلیه |
EXCLUSIVE | این وسیله نقلیه در حال حاضر هیچ سفری به آن ندارد و می تواند به نقطه وانت برود. |
BACK_TO_BACK | این وسیله نقلیه در حال حاضر به یک سفر اختصاص داده شده است ، اما می تواند پس از اتمام سفر در حال پیشرفت به نقطه وانت برود. محاسبات ETA و فاصله سفر موجود را در نظر می گیرد. |
CARPOOL | این وسیله نقلیه از ظرفیت کافی برای یک سواری مشترک برخوردار است. |
CARPOOL_BACK_TO_BACK | این وسیله نقلیه قبل از حرکت به نقطه وانت ، سفر فعلی و فعال خود را به پایان می رساند. محاسبات ETA و فاصله سفر موجود را در نظر می گیرد. |
محل زندگی
وضعیت Vehicle
.
Enums | |
---|---|
UNKNOWN_VEHICLE_STATE | پیش فرض ، برای حالت های خودروهای نامشخص یا ناشناخته استفاده می شود. |
OFFLINE | وسیله نقلیه سفرهای جدیدی را نمی پذیرد. توجه: وسیله نقلیه ممکن است ضمن تکمیل سفر اختصاص داده شده به آن ، در این حالت فعالیت کند. |
ONLINE | وسیله نقلیه در حال پذیرش سفرهای جدید است. |
VisualTrafficReportPolynerendering
توصیف می کند که چگونه مشتری باید یک قسمت از پلی خط را در طول مسیر رنگ کند.
فیلدها | |
---|---|
road_stretch[] | اختیاری. امتداد جاده ای که باید در امتداد پلی خط ارائه شود. کشش ها تضمین می شوند که با هم همپوشانی نکنند و لزوماً مسیر کامل را طی نمی کنند. در صورت عدم وجود کشش جاده ای به سبک ، مشتری باید پیش فرض مسیر را اعمال کند. |
پیشرو
یک کشش جاده ای که باید ارائه شود.
فیلدها | |
---|---|
style | مورد نیاز. سبک برای اعمال |
offset_meters | مورد نیاز. این سبک باید بین |
length_meters | مورد نیاز. طول مسیر که در آن سبک استفاده شود. |
سبک
سبک ترافیک ، نشانگر سرعت ترافیک است.
Enums | |
---|---|
STYLE_UNSPECIFIED | بدون سبکی انتخاب نشده است. |
SLOWER_TRAFFIC | ترافیک در حال کند شدن است. |
TRAFFIC_JAM | یک ترافیک وجود دارد. |
نقطه راه
نقاط واسطه ای را در طول مسیر برای یک VehicleMatch
در یک SearchVehiclesResponse
توصیف می کند. این مفهوم در تمام نقاط پایانی دیگر به عنوان یک TripWaypoint
نشان داده شده است.
فیلدها | |
---|---|
lat_lng | محل این ایستگاه راه. |
eta | زمان تخمینی که وسیله نقلیه به این نقطه راه می رسد. |
نقطه WaypointType
نوع Waypoint.
Enums | |
---|---|
UNKNOWN_WAYPOINT_TYPE | نوع ایستگاه ناشناخته یا نامشخص. |
PICKUP_WAYPOINT_TYPE | ایستگاه های راه برای برداشتن سواران یا موارد. |
DROP_OFF_WAYPOINT_TYPE | ایستگاه های راه برای رها کردن سواران یا موارد. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE | ایستگاه های راه برای مقصد واسطه در یک سفر چند خوابه. |