VehicleLocation

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

تمثيل 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 (LocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (LocationSensor),
  "rawLocationAccuracy": number,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (LocationSensor),
  "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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
locationSensor

enum (LocationSensor)

موفِّر بيانات الموقع الجغرافي (على سبيل المثال، 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 (LocationSensor)

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

number

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

object (LatLng)

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

string (Timestamp format)

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

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

enum (LocationSensor)

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

number

دقة supplementalLocation كنطاق جغرافي، بالمتر
roadSnapped
(deprecated)

boolean

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

LocationSensor

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

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