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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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 رقم تعريف البرج الخلوي أو نقطة وصول 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