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.

PolylineFormatType

تمثّل هذه السمة نوع تنسيق الخطوط المتعددة.

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