DeliveryVehicleLocation

الموقع الجغرافي للمركبة وسرعتها وعنوانها في وقت محدّد

تمثيل JSON
{
  "location": {
    object (LatLng)
  },
  "horizontalAccuracy": number,
  "latlngAccuracy": number,
  "heading": integer,
  "bearingAccuracy": number,
  "headingAccuracy": number,
  "altitude": number,
  "verticalAccuracy": number,
  "altitudeAccuracy": number,
  "speedKmph": integer,
  "speed": number,
  "speedAccuracy": number,
  "updateTime": string,
  "serverTime": string,
  "locationSensor": enum (DeliveryVehicleLocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (DeliveryVehicleLocationSensor),
  "rawLocationAccuracy": number,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (DeliveryVehicleLocationSensor),
  "supplementalLocationAccuracy": number,
  "roadSnapped": boolean
}
الحقول
location

object (LatLng)

الموقع الجغرافي للمركبة عند إرسالها إلى Fleet Engine، يكون الموقع الجغرافي للمركبة هو موقع جغرافي وفقًا لنظام تحديد المواقع العالمي (GPS). وعند تلقّيه ردًّا، يمكن أن يكون الموقع الجغرافي للمركبة إمّا موقعًا جغرافيًا لنظام تحديد المواقع العالمي (GPS) أو موقعًا تكميليًا أو أي موقع جغرافي مقدَّر آخر. يتم تحديد المصدر في locationSensor.

horizontalAccuracy
(deprecated)

number

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام latlngAccuracy بدلاً منها.

latlngAccuracy

number

دقة location متر كنصف قطر

heading

integer

اتجاه حركة المركبة بالدرجات 0 يمثل الشمال. النطاق الصالح هو [0,360).

bearingAccuracy
(deprecated)

number

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام headingAccuracy بدلاً منها.

headingAccuracy

number

درجة دقة heading بالدرجات.

altitude

number

الارتفاع بالأمتار فوق WGS84

verticalAccuracy
(deprecated)

number

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام altitudeAccuracy بدلاً منها.

altitudeAccuracy

number

دقة altitude متر

speedKmph
(deprecated)

integer

سرعة المركبة بالكيلومتر في الساعة. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام speed بدلاً منها.

speed

number

سرعة المركبة بالمتر/الثانية

speedAccuracy

number

دقة speed متر في الثانية

updateTime

string (Timestamp format)

الوقت الذي سجّل فيه جهاز الاستشعار قيمة location وفقًا لساعته

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

serverTime

string (Timestamp format)

النتائج فقط. الوقت الذي تلقّى فيه الخادم معلومات الموقع الجغرافي.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

locationSensor

enum (DeliveryVehicleLocationSensor)

موفِّر بيانات الموقع الجغرافي (على سبيل المثال، GPS).

isRoadSnapped

boolean

ما إذا كان قد تم محاذاة location إلى طريق أم لا.

isGpsSensorEnabled

boolean

الإدخال فقط. يشير إلى ما إذا كان جهاز استشعار GPS مفعّلاً على الجهاز الجوّال.

timeSinceUpdate

integer

الإدخال فقط. الوقت (بالثواني) منذ إرسال هذا الموقع الجغرافي لأول مرة إلى الخادم سيكون هذا صفرًا في أول تحديث. إذا كان الوقت غير معروف (على سبيل المثال، عند إعادة تشغيل التطبيق)، تتم إعادة ضبط هذه القيمة على القيمة صفر.

numStaleUpdates
(deprecated)

integer

الإدخال فقط. متوقّف: يتم الآن استخدام إشارات أخرى لتحديد ما إذا كان الموقع قديمًا أم لا.

rawLocation

object (LatLng)

الموقع الجغرافي للمركبة الأولي (لا تتم معالجته بواسطة قاذف الطريق)

rawLocationTime

string (Timestamp format)

الطابع الزمني المرتبط بالموقع الجغرافي الأولي

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

rawLocationSensor

enum (DeliveryVehicleLocationSensor)

مصدر الموقع الجغرافي الأولي وتكون القيمة التلقائية هي GPS.

rawLocationAccuracy

number

دقة rawLocation كنطاق جغرافي، بالمتر

supplementalLocation

object (LatLng)

الموقع التكميلي الذي يوفره التطبيق المدمج

supplementalLocationTime

string (Timestamp format)

الطابع الزمني المرتبط بالموقع الجغرافي التكميلي

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

supplementalLocationSensor

enum (DeliveryVehicleLocationSensor)

مصدر الموقع التكميلي وتكون القيمة التلقائية هي CUSTOMER_SUPPLIED_LOCATION.

supplementalLocationAccuracy

number

دقة supplementalLocation كنصف قطر، بالمتر

roadSnapped
(deprecated)

boolean

متوقّفة نهائيًا: استخدِم isRoadSnapped بدلاً منها.

DeliveryVehicleLocationSensor

أداة الاستشعار أو المنهجية المستخدمة لتحديد الموقع الجغرافي.

عمليات التعداد
UNKNOWN_SENSOR أداة الاستشعار غير محدّدة أو غير معروفة.
GPS نظام تحديد المواقع العالمي (GPS) أو نظام تحديد المواقع العالمي المساعد
NETWORK نظام تحديد المواقع العالمي (GPS) أو معرِّف برج الاتصالات أو نقطة وصول WiFi.
PASSIVE معرّف برج الاتصالات أو نقطة وصول WiFi.
ROAD_SNAPPED_LOCATION_PROVIDER الموقع الجغرافي الذي يحدده الجهاز الجوّال على أنّه الموقع الأكثر احتمالًا على الطريق
CUSTOMER_SUPPLIED_LOCATION موقع جغرافي يوفّره العميل من مصدر مستقل. يتم عادةً استخدام هذه القيمة للموقع الجغرافي الذي يتم تقديمه من مصادر أخرى غير الجهاز الجوّال الذي يشغل حزمة SDK لبرنامج التشغيل. إذا تم وصف المصدر الأصلي بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. يتم عادةً توفير المواقع الجغرافية التي تم وضع علامة CUSTOMER_SUPPLIED_LOCATION عليها عبر lastLocation.supplemental_location_sensor الخاصة بـ DeliveryVehicle.
FLEET_ENGINE_LOCATION موقع جغرافي يحتسبه Fleet Engine استنادًا إلى الإشارات المتاحة له النتائج فقط. سيتم رفض هذه القيمة إذا تم استلامها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم خدمات الموقع الجغرافي على أنظمة التشغيل من Apple