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,
  "flpLocation": {
    object (LatLng)
  },
  "flpUpdateTime": string,
  "flpLatlngAccuracyMeters": number,
  "flpHeadingDegrees": integer,
  "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 وفقًا لساعة جهاز الاستشعار.

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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-normalized ويستخدم 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 (LocationSensor)

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

boolean

تُستخدَم لتحديد ما إذا كان location محاذيًا لطريق.
isGpsSensorEnabled

boolean

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

integer

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

integer

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

object (LatLng)

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

string (Timestamp format)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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 (LocationSensor)

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

number

تمثّل هذه السمة دقة rawLocation كنصف قطر، وذلك بالمتر.
flpLocation

object (LatLng)

الموقع الجغرافي من ميزة "موفِّر الموقع المدمج" من Android
flpUpdateTime

string (Timestamp format)

الطابع الزمني لتعديل flpLocation

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
flpLatlngAccuracyMeters

number

دقة flpLocation بالأمتار كنصف قطر
flpHeadingDegrees

integer

الاتجاه الذي تتحرّك فيه المركبة بالدرجات، كما يحدّده "موفِّر الموقع المدمج" يمثّل الرقم 0 الشمال. النطاق الصالح هو [0,360).
supplementalLocation

object (LatLng)

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

string (Timestamp format)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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 (LocationSensor)

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

number

تمثّل هذه السمة دقة supplementalLocation كنصف قطر، وذلك بالمتر.
roadSnapped
(deprecated)

boolean

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

LocationSensor

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

عمليات التعداد
UNKNOWN_SENSOR جهاز الاستشعار غير محدّد أو غير معروف.
GPS نظام تحديد المواقع العالمي (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 في المركبة.
FLEET_ENGINE_LOCATION موقع جغرافي تحسبه Fleet Engine استنادًا إلى الإشارات المتاحة لها. النتائج فقط. سيتم رفض هذه القيمة إذا تم تلقّيها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم خدمة تحديد الموقع الجغرافي على أنظمة تشغيل Apple