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 له. إذا لم تتغيّر بيانات المسار منذ هذا الطابع الزمني، لن يتم ضبط حقل المسار في الردّ. إذا لم يتم تحديد حدّ أدنى، يتم استرداد بيانات المسار دائمًا.

يستخدم معيار 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"
remainingWaypointsVersion
(deprecated)

string (Timestamp format)

متوقف نهائيًا: يتم دائمًا استرداد Trip.remaining_waypoints. استخدِم remainingWaypointsRouteVersion للتحكّم في وقت استرداد بيانات Trip.remaining_waypoints.traffic_to_waypoint وTrip.remaining_waypoints.path_to_waypoint.

يستخدم معيار 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"
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 في الاستجابة. في حال عدم تحديد حدّ أدنى، يتم استرداد بيانات الزيارات دائمًا. تجدر الإشارة إلى أنّ الزيارات لا تتوفّر إلا لعملاء "حلول متعلقة بعمليات التسليم والرحلات عند الطلب".

يستخدم معيار 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"
remainingWaypointsRouteVersion

string (Timestamp format)

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

يستخدم معيار 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"

نص الطلب

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

نص الاستجابة

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

PolylineFormatType

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

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