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 |
string (Timestamp format)
يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرداد Trip.remaining_waypoints من أجله. إذا لم يتم تغييرها منذ الطابع الزمني هذا، لن يتم ضبط remainingWaypoints في الردّ. إذا لم يتم تحديد هذا الحقل، يتم استرداد remainingWaypoints دائمًا. يستخدم معيار 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-01-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]
