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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
serverTime

string (Timestamp format)

פלט בלבד. השעה שבה השרת קיבל את פרטי המיקום.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

טיפוסים בני מנייה (enums)
UNKNOWN_SENSOR החיישן לא צוין או לא ידוע.
GPS GPS או 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 ספק המיקום Fused של Android.
CORE_LOCATION ספק המיקום במערכות ההפעלה של Apple.