المرجع: رحلة
البيانات الوصفية للرحلة
تمثيل JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. بالتنسيق "providers/{provider}/trips/{trip}" |
vehicleId |
رقم تعريف المركبة التي تجري هذه الرحلة |
tripStatus |
الحالة الحالية للرحلة |
tripType |
نوع الرحلة. |
pickupPoint |
تشير إلى الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم توصيل الطلب منه. |
actualPickupPoint |
الإدخال فقط. الموقع الجغرافي الفعلي وقت ومكان استلام العميل. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات حول معلومات الاستلام الفعلية. |
actualPickupArrivalPoint |
الإدخال فقط. الوقت الفعلي والموقع الجغرافي لوصول السائق إلى نقطة الاستلام هذا الحقل مخصّص لمقدّم الخدمة ليقدّم ملاحظات حول معلومات الوصول الفعلية إلى نقطة الاستلام. |
pickupTime |
النتائج فقط. سواء الوقت المقدر في المستقبل الذي سيتم فيه نقل الركاب أو الوقت الفعلي الذي تم التقاطهم فيه. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
intermediateDestinations[] |
محطّات متوسطة للتوقّف من أجل طلب الرحلات (بالإضافة إلى الاستلام والتوصيل) في البداية، لن تكون هذه الميزة متوفّرة للرحلات المشتركة. |
intermediateDestinationsVersion |
يشير هذا الحقل إلى آخر مرة تم فيها تعديل طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
intermediateDestinationIndex |
عندما تكون قيمة الحقل " |
actualIntermediateDestinationArrivalPoints[] |
الإدخال فقط. الوقت الفعلي والموقع الجغرافي لوصول السائق إلى وجهة متوسطة. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات عن معلومات الوصول الفعلية إلى الوجهات المتوسطة. |
actualIntermediateDestinations[] |
الإدخال فقط. الوقت والمكان الفعليان الذي تم فيه نقل العميل من وجهة وسيطة. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات حول معلومات الاستلام الفعلية في الوجهات المتوسطة. |
dropoffPoint |
الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم تسليمه |
actualDropoffPoint |
الإدخال فقط. الوقت والمكان الفعليان الذي انزل فيه العميل إلى الفندق. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات حول معلومات الانسحاب الفعلية. |
dropoffTime |
النتائج فقط. إما الوقت المستقبلي المقدر الذي سيتم فيه تسليم الركاب في الوجهة النهائية، أو الوقت الفعلي الذي تم فيه تسليمهم. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingWaypoints[] |
النتائج فقط. تمثّل هذه السمة المسار الكامل من الموقع الجغرافي الحالي إلى نقطة التسليم. يمكن أن يتضمن هذا المسار نقاط الطريق من الرحلات الأخرى. |
vehicleWaypoints[] |
يتيح هذا الحقل الترتيب اليدوي لنقاط الطريق للرحلة. وتحتوي على جميع نقاط الطريق المتبقية للمركبة المحدّدة، بالإضافة إلى نقاط طريق الركوب والتسليم لهذه الرحلة. إذا لم يتم تخصيص الرحلة لمركبة، يتجاهل Fleet Engine هذا الحقل. لأسباب تتعلق بالخصوصية، لا تتم تعبئة هذا الحقل إلا من خلال الخادم في مكالمات |
route[] |
النتائج فقط. المسار المتوقع لهذه الرحلة إلى المدخل الأول في نقاط الطريق المتبقية. يُرجى العِلم أنّ نقطة الطريق الأولى قد تنتمي إلى رحلة مختلفة. |
currentRouteSegment |
النتائج فقط. مسار مشفر إلى نقطة الطريق التالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. لا تتوفّر إمكانية فك الترميز بعد. |
currentRouteSegmentVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
currentRouteSegmentTraffic |
النتائج فقط. تشير هذه السمة إلى أحوال حركة المرور على طول ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. |
currentRouteSegmentTrafficVersion |
النتائج فقط. يشير هذا الحقل إلى آخر مرة تم فيها تعديل ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
currentRouteSegmentEndPoint |
النتائج فقط. تمثّل هذه السمة النقطة المسارية التي ينتهي عندها |
remainingDistanceMeters |
النتائج فقط. مسافة القيادة المتبقية في حقل |
etaToFirstWaypoint |
النتائج فقط. الوقت المقدر للوصول إلى نقطة الطريق التالية (الإدخال الأول في الحقل طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingTimeToFirstWaypoint |
النتائج فقط. المدة التي تبدأ من وقت إرجاع بيانات الرحلة إلى الوقت في مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
remainingWaypointsVersion |
النتائج فقط. تشير إلى آخر مرة تم فيها تغيير طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingWaypointsRouteVersion |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
stopTime |
الإدخال فقط. تمّ الإيقاف. استخدِم حقل الطابع الزمني. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
TripView
أداة اختيار مجموعات مختلفة من حقول "الرحلة" في ردّ "trips.get
" راجع AIP-157 لمعرفة السياق. من المرجح أن تتم إضافة مشاهدات إضافية.
عمليات التعداد | |
---|---|
TRIP_VIEW_UNSPECIFIED |
القيمة التلقائية. بالنسبة إلى التوافق مع الأنظمة القديمة، سيتم ضبط واجهة برمجة التطبيقات تلقائيًا على طريقة عرض حزمة تطوير البرامج (SDK). لضمان الاستقرار والدعم، ننصح العملاء باختيار TripView بخلاف SDK . |
SDK |
تتضمّن الحقول التي قد لا تكون قابلة للتفسير أو الدعم باستخدام المكتبات المتاحة للجميع. |
JOURNEY_SHARING_V1S |
تتم تعبئة حقول الرحلة لحالة استخدام "مشاركة الرحلة". تم تصميم طريقة العرض هذه لاتصالات خادم إلى خادم. |
الطُرق |
|
---|---|
|
ينشئ رحلة في Fleet Engine ويعرض الرحلة الجديدة. |
|
الحصول على معلومات عن رحلة واحدة |
|
يمكنك الاطّلاع على جميع الرحلات لمركبة معيّنة. |
|
تعدّل بيانات الرحلة. |