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 דווח על ידי החיישן לפי השעון של החיישן.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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)

מיקום הרכב הגולמי (לא עבר עיבוד על ידי road-snapper).
rawLocationTime

string (Timestamp format)

חותמת הזמן שמשויכת למיקום הגולמי.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 כרדיום, במטרים.
supplementalLocation

object (LatLng)

מיקום משלים שמסופק על ידי האפליקציה המשולבת.
supplementalLocationTime

string (Timestamp format)

חותמת הזמן שמשויכת למיקום המשלים.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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

החיישן או השיטה ששימשו לקביעת המיקום.

טיפוסים בני מנייה (enum)
UNKNOWN_SENSOR החיישן לא צוין או לא ידוע.
GPS GPS או Assisted GPS.
NETWORK GPS משופר, מזהה מגדל תקשורת או נקודת גישה ל-Wi-Fi.
PASSIVE מזהה של תורן סלולרי או נקודת גישה ל-Wi-Fi.
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 ספק המיקום המשולב של Android.
CORE_LOCATION ספק המיקום במערכות ההפעלה של Apple.