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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد Trip.remaining_waypoints له. وإذا لم تتغيّر منذ هذا الطابع الزمني، لن يتم ضبط remainingWaypoints في الردّ. في حال عدم تحديد هذا الحقل، يتم استرداد remainingWaypoints دائمًا.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Trip.

PolylineFormatType

نوع تنسيق الخطوط المتعددة.

عمليات التعداد
UNKNOWN_FORMAT_TYPE التنسيق غير محدد أو غير معروف.
LAT_LNG_LIST_TYPE هذه قائمة بـ google.type.LatLng.
ENCODED_POLYLINE_TYPE يشير ذلك المصطلح إلى مخطط متعدد الخطوط تم ترميزه باستخدام خوارزمية ضغط الخطوط المتعددة. لا تتوفّر إمكانية فك الترميز بعد.