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 وفقًا لساعته

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

serverTime

string (Timestamp format)

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

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

locationSensor

enum (DeliveryVehicleLocationSensor)

مقدّم بيانات الموقع الجغرافي (مثل GPS)

isRoadSnapped

boolean

ما إذا كان location ملتصقًا بطريق

isGpsSensorEnabled

boolean

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

timeSinceUpdate

integer

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

numStaleUpdates
(deprecated)

integer

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

rawLocation

object (LatLng)

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

rawLocationTime

string (Timestamp format)

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

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

rawLocationSensor

enum (DeliveryVehicleLocationSensor)

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

rawLocationAccuracy

number

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

supplementalLocation

object (LatLng)

الموقع الجغرافي الإضافي الذي يقدّمه التطبيق المُدمَج

supplementalLocationTime

string (Timestamp format)

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

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

supplementalLocationSensor

enum (DeliveryVehicleLocationSensor)

مصدر الموقع الجغرافي الإضافي القيمة التلقائية هي CUSTOMER_SUPPLIED_LOCATION.

supplementalLocationAccuracy

number

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

roadSnapped
(deprecated)

boolean

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

DeliveryVehicleLocationSensor

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

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