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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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 رقم تعريف البرج الخلوي أو نقطة وصول Wi-Fi
ROAD_SNAPPED_LOCATION_PROVIDER الموقع الجغرافي الذي يحدده الجهاز الجوّال على أنّه الموقع الأكثر احتمالًا على الطريق
CUSTOMER_SUPPLIED_LOCATION موقع جغرافي يقدّمه العميل من مصدر مستقل وعادةً ما يتم استخدام هذه القيمة لموقع جغرافي يتم توفيره من مصادر أخرى غير الجهاز الجوّال الذي يعمل بنظام التشغيل Driver SDK. إذا كان المصدر الأصلي موضّحًا بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. يتم عادةً تقديم المواقع الجغرافية التي تم وضع علامة CUSTOMER_SUPPLIED_LOCATION عليها من خلال lastLocation.supplemental_location_sensor في DeliveryVehicle.
FLEET_ENGINE_LOCATION موقع جغرافي يحتسبه Fleet Engine استنادًا إلى الإشارات المتاحة له النتائج فقط. سيتم رفض هذه القيمة إذا تم استلامها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم الموقع الجغرافي على أنظمة التشغيل من Apple