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 וישתמש ב-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 וישתמש ב-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)

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

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-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 וישתמש ב-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 וישתמש ב-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

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

טיפוסים בני מנייה (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 ספק המיקום במערכות הפעלה של אפל.