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 استفاده کنید.

سنسور مکان

سنسور یا روش مورد استفاده برای تعیین مکان.

Enums
UNKNOWN_SENSOR سنسور نامشخص یا ناشناخته است.
GPS GPS یا کمکی GPS.
NETWORK GPS کمکی، شناسه برج سلولی، یا نقطه دسترسی WiFi.
PASSIVE شناسه برج سلولی یا نقطه دسترسی WiFi.
ROAD_SNAPPED_LOCATION_PROVIDER مکانی که توسط دستگاه تلفن همراه به عنوان محتمل ترین موقعیت جاده تعیین می شود.
CUSTOMER_SUPPLIED_LOCATION مکان ارائه شده توسط مشتری از یک منبع مستقل. به طور معمول، این مقدار برای مکانی استفاده می‌شود که از منابعی غیر از دستگاه تلفن همراهی که Driver SDK را اجرا می‌کند، ارائه می‌شود. اگر منبع اصلی با یکی از مقادیر enum دیگر توصیف شده است، از آن مقدار استفاده کنید. مکان‌هایی که CUSTOMER_SUPPLIED_LOCATION علامت‌گذاری شده‌اند معمولاً از طریق lastLocation.supplemental_location_sensor یک وسیله نقلیه ارائه می‌شوند.
FLEET_ENGINE_LOCATION مکانی که توسط Fleet Engine بر اساس سیگنال های موجود محاسبه می شود. فقط خروجی اگر این مقدار در یک درخواست دریافت شود رد می شود.
FUSED_LOCATION_PROVIDER ارائه دهنده مکان Fused Android.
CORE_LOCATION ارائه دهنده مکان در سیستم عامل های اپل.