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 رقم تعريف البرج الخلوي أو نقطة وصول WiFi.
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.