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

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

טיפוסים בני מנייה (enum)
UNKNOWN_SENSOR החיישן לא מוגדר או לא ידוע.
GPS GPS או Assist 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.