Method: providers.vehicles.get
یک وسیله نقلیه را از موتور ناوگان برمیگرداند.
درخواست HTTP
GET https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
name | string مورد نیاز. باید در قالب providers/{provider}/vehicles/{vehicle} باشد. ارائهدهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار میکند عضوی از آن است. |
پارامترهای پرس و جو
پارامترها |
---|
header | object ( RequestHeader ) هدر درخواست استاندارد Fleet Engine. |
currentRouteSegmentVersion | string ( Timestamp format) حداقل مهر زمانی (انحصاری) که Vehicle.current_route_segment برای آن بازیابی شده است را نشان می دهد. اگر مسیر از این مهر زمانی تغییر نکرده باشد، فیلد currentRouteSegment در پاسخ تنظیم نشده است. اگر حداقل مشخص نشده باشد، قطعه currentRouteSegment همیشه بازیابی می شود. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" . |
waypointsVersion | string ( Timestamp format) حداقل مهر زمانی (انحصاری) که دادههای Vehicle.waypoints برای آن بازیابی شده است را نشان میدهد. اگر نقاط راه از زمان این مهر زمانی تغییری نکرده باشند، دادههای vehicle.waypoints در پاسخ تنظیم نمیشوند. اگر این فیلد مشخص نشده باشد، vehicle.waypoints همیشه بازیابی می شود. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" . |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Vehicle
است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-02-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-02-26 بهوقت ساعت هماهنگ جهانی."],[[["Retrieves a vehicle's real-time information, such as location and status, from the Fleet Engine."],["Requires specifying the provider and vehicle IDs in the URL path."],["Optionally, allows filtering the retrieved data by timestamps for route segment and waypoints."],["Request body should be left empty."],["A successful response provides detailed vehicle data including its current state and attributes."]]],["This document details retrieving a vehicle from the Fleet Engine using a `GET` request. The URL format is `https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}`, with the `name` path parameter specifying the provider and vehicle. Query parameters include `header` for the Fleet Engine request header, `currentRouteSegmentVersion` and `waypointsVersion` which allow for conditional data retrieval based on timestamps. The request body is empty, and a successful response contains a `Vehicle` instance.\n"]]