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 يشير ذلك المصطلح إلى مخطط متعدد الخطوط تم ترميزه باستخدام خوارزمية ضغط الخطوط المتعددة. ميزة فك التشفير غير متاحة بعد.