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