Method: providers.trips.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على معلومات عن رحلة واحدة
طلب HTTP
GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. يجب أن يكون بالتنسيق providers/{provider}/trips/{trip}. يجب أن يكون مقدّم الخدمة هو رقم تعريف المشروع (على سبيل المثال، sample-cloud-project) لمشروع Google Cloud الذي يكون حساب الخدمة الذي يجري هذا الطلب عضوًا فيه.
|
مَعلمات طلب البحث
| المعلمات |
header |
object (RequestHeader)
عنوان طلب Fleet Engine العادي
|
view |
enum (TripView)
مجموعة فرعية من حقول الرحلة التي يجب عرضها وتفسيرها
|
currentRouteSegmentVersion |
string (Timestamp format)
يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرجاع بيانات Trip.route أو Trip.current_route_segment له. إذا لم تتغيّر بيانات المسار منذ الطابع الزمني هذا، لن يتم ضبط حقل المسار في الردّ. إذا لم يتم تحديد حدّ أدنى، يتم استرداد بيانات المسار دائمًا. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
remainingWaypointsVersion |
string (Timestamp format)
يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرداد Trip.remaining_waypoints له. وفي حال عدم تغيير هذه السمة منذ هذا الطابع الزمني، لن يتم ضبط remainingWaypoints في الردّ. إذا لم يتم تحديد هذا الحقل، يتم استرداد remainingWaypoints دائمًا. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
routeFormatType |
enum (PolylineFormatType)
تنسيق المسار الحالي الذي يتم إرجاعه، LAT_LNG_LIST_TYPE (في Trip.route) أو ENCODED_POLYLINE_TYPE (في Trip.current_route_segment). الإعداد التلقائي هو LAT_LNG_LIST_TYPE.
|
currentRouteSegmentTrafficVersion |
string (Timestamp format)
يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرداد Trip.current_route_segment_traffic له. إذا لم تتغيّر بيانات الزيارات منذ الطابع الزمني هذا، لن يتم ضبط الحقل currentRouteSegmentTraffic في الاستجابة. في حال عدم تحديد حدّ أدنى، يتم استرداد بيانات الزيارات دائمًا. تجدر الإشارة إلى أنّ الزيارات لا تتوفّر إلا لعملاء "حلول متعلقة بعمليات التسليم والرحلات عند الطلب". طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
remainingWaypointsRouteVersion |
string (Timestamp format)
يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرجاع بيانات Trip.remaining_waypoints.traffic_to_waypoint وTrip.remaining_waypoints.path_to_waypoint له. إذا لم تتغيّر البيانات منذ الطابع الزمني هذا، لن يتم ضبط الحقول أعلاه في الاستجابة. إذا لم يتم تحديد remainingWaypointsRouteVersion، يتم دائمًا استرداد عدد الزيارات والمسار. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Trip.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves detailed trip information for a specified provider and trip ID."],["Allows customization of the data returned using query parameters such as `view`, `routeFormatType`, and various version parameters."],["Requires an empty request body and a valid `name` path parameter in the format `providers/{provider}/trips/{trip}`."],["If successful, the response includes a `Trip` object containing comprehensive trip details."],["Offers the flexibility to request routes in either `LAT_LNG_LIST_TYPE` or `ENCODED_POLYLINE_TYPE` format."]]],[]]
