المرجع: رحلة
البيانات الوصفية للرحلة.
تمثيل JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. بالتنسيق "providers/{provider}/trips/{trip}" |
vehicleId |
رقم تعريف المركبة التي تنفّذ هذه الرحلة. |
tripStatus |
حالة الرحلة الحالية. |
tripType |
نوع الرحلة. |
pickupPoint |
الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم استلامه |
actualPickupPoint |
الإدخال فقط. الموقع الجغرافي الفعلي حيث تم نقل العميل إلى مكانه وزمانه هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات وآراء حول معلومات الاستلام الفعلية. |
actualPickupArrivalPoint |
الإدخال فقط. الوقت والموقع الجغرافي الفعلي لوصول السائق إلى نقطة الاستلام. هذا الحقل مخصَّص لتقديم ملاحظات عن معلومات الوصول الفعلية إلى نقطة الاستلام. |
pickupTime |
النتائج فقط. إما الوقت المستقبلي المقدر الذي سيتم فيه اصطحاب الراكبين، أو الوقت الفعلي الذي تم فيه اصطحابهم. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
intermediateDestinations[] |
يتوقف وسيط على إجراء طلبات الرحلة (بالإضافة إلى الاستلام والمغادرة). في البداية، لن يكون هذا الخيار متاحًا للرحلات المشترَكة. |
intermediateDestinationsVersion |
يشير إلى آخر مرة تم فيها تعديل طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
intermediateDestinationIndex |
عندما تكون قيمة الحقل " |
actualIntermediateDestinationArrivalPoints[] |
الإدخال فقط. الوقت والموقع الفعلي لوصول السائق إلى وجهة وسيطة. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات عن معلومات الوصول الفعلية إلى وجهات وسيطة. |
actualIntermediateDestinations[] |
الإدخال فقط. تمثّل هذه السمة الوقت والمكان الفعليَين حيث تم اختيار العميل من وجهة وسيطة ومكانه. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات وآراء حول معلومات الاستلام الفعلية في الوجهات المتوسطة. |
dropoffPoint |
الموقع الجغرافي الذي يشير فيه العميل إلى أنه سيتم تسليمه. |
actualDropoffPoint |
الإدخال فقط. الوقت والمكان الفعليين لإنزال العميل ومكان تسليمه. هذا الحقل مخصص لمقدم الخدمة لتقديم ملاحظات وآراء عن معلومات الانسحاب الفعلية. |
dropoffTime |
النتائج فقط. إما الوقت المستقبلي المقدر الذي سيتم فيه تسليم الركاب في الوجهة النهائية، أو الوقت الفعلي الذي تم تسليمهم فيه. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingWaypoints[] |
النتائج فقط. المسار الكامل من الموقع الحالي إلى نقطة الانسحاب، شاملًا. يمكن أن يتضمن هذا المسار نقاط الطريق من الرحلات الأخرى. |
vehicleWaypoints[] |
يتيح هذا الحقل الترتيب اليدوي لنقاط الطريق الخاصة بالرحلة. يتضمّن الملف جميع نقاط الطريق المتبقية للمركبة المخصصة لها، بالإضافة إلى نقاط طرق الاستلام والتسليم لهذه الرحلة. في حال لم يتم تعيين الرحلة لمركبة، سيتجاهل Fleet Engine هذا الحقل. لأسباب تتعلق بالخصوصية، تتم تعبئة هذا الحقل عن طريق الخادم في مكالمات |
route[] |
النتائج فقط. المسار المتوقع لهذه الرحلة إلى المدخل الأول في نقاط الطريق المتبقية. تجدر الإشارة إلى أن النقطة الأولى قد تنتمي إلى رحلة مختلفة. |
currentRouteSegment |
النتائج فقط. مسار مُشفَّر إلى نقطة الطريق التالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك". لا تتوفّر إمكانية فك الترميز بعد. |
currentRouteSegmentVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك". طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
currentRouteSegmentTraffic |
النتائج فقط. تشير إلى ظروف حركة المرور على طول ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك". |
currentRouteSegmentTrafficVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك". طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
currentRouteSegmentEndPoint |
النتائج فقط. النقطة التي ينتهي عندها |
remainingDistanceMeters |
النتائج فقط. مسافة القيادة المتبقية في حقل |
etaToFirstWaypoint |
النتائج فقط. الوقت المقدر للوصول إلى نقطة الطريق التالية (الإدخال الأول في حقل طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingTimeToFirstWaypoint |
النتائج فقط. المدة بدءًا من إرجاع بيانات الرحلة إلى الوقت في مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ " |
remainingWaypointsVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تغيير طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingWaypointsRouteVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
numberOfPassengers |
غير قابل للتغيير. تشير هذه القيمة إلى عدد الركاب في هذه الرحلة ولا تشمل السائق. يجب أن تتوفّر للمركبة القدرة على إرجاعها بعد الاستجابة |
lastLocation |
النتائج فقط. يشير إلى آخر موقع تم الإبلاغ عنه للمركبة على طول المسار. |
lastLocationSnappable |
النتائج فقط. يشير إلى ما إذا كان يمكن ضبط |
view |
المجموعة الفرعية من حقول الرحلة التي تتم تعبئتها وكيفية تفسيرها. |
TripStatus
حالة الرحلة التي تشير إلى تقدمها.
عمليات التعداد | |
---|---|
UNKNOWN_TRIP_STATUS |
الخيار التلقائي، يُستخدَم مع حالة رحلة غير محدّدة أو غير معروفة. |
NEW |
رحلة تم إنشاؤها حديثًا. |
ENROUTE_TO_PICKUP |
السائق في طريقه إلى نقطة الاستلام. |
ARRIVED_AT_PICKUP |
وصل السائق إلى نقطة الاستلام. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
وصل السائق إلى وجهة وسيطة وينتظر الراكب. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
السائق في طريقه إلى وجهة وسيطة (ليست نقطة انزلاق). |
ENROUTE_TO_DROPOFF |
قبض السائق على الراكب وهو في طريقه إلى الوجهة التالية. |
COMPLETE |
تم إسقاط الراكب واكتملت الرحلة. |
CANCELED |
تم إلغاء الرحلة قبل استلام السائق أو الراكب أو مقدّم خدمة مشاركة الرحلات. |
StopLocation
الموقع الفعلي الذي حدث فيه التوقف (الاستلام/المغادرة).
تمثيل JSON |
---|
{
"point": {
object ( |
الحقول | |
---|---|
point |
مطلوبة. تشير إلى الموقع الجغرافي الفعلي. |
timestamp |
تشير هذه السمة إلى وقت حدوث التوقّف. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
stopTime |
الإدخال فقط. تمّ الإيقاف. استخدام حقل الطابع الزمني طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
TripView
أداة اختيار لمجموعات مختلفة من حقول "الرحلة" في استجابة trips.get
يُرجى مراجعة AIP-157 للاطّلاع على السياق. من المحتمل أن تتم إضافة ملفات شخصية إضافية.
عمليات التعداد | |
---|---|
TRIP_VIEW_UNSPECIFIED |
القيمة التلقائية. للتوافق مع الأنظمة القديمة، سيتم ضبط واجهة برمجة التطبيقات تلقائيًا على عرض SDK. لضمان الاستقرار والدعم، ننصح العملاء باختيار TripView بخلاف SDK . |
SDK |
تشتمل هذه الفئة على الحقول التي قد لا تكون قابلة للتفسير أو الدعم باستخدام المكتبات المتاحة للجميع. |
JOURNEY_SHARING_V1S |
تتم تعبئة حقول الرحلات لحالة استخدام ميزة "المشاركة في الرحلة". تم تصميم طريقة العرض هذه لاتصالات الخادم إلى الخادم. |
الطُرق |
|
---|---|
|
ينشئ رحلة في Fleet Engine ويعيد الرحلة الجديدة. |
|
الحصول على معلومات عن رحلة واحدة |
|
الحصول على جميع الرحلات لمركبة معيّنة |
|
لتعديل بيانات الرحلة |