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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
serverTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่เซิฟเวอร์ได้รับข้อมูลตำแหน่ง

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
locationSensor

enum (LocationSensor)

ผู้ให้บริการข้อมูลตำแหน่ง (เช่น GPS)
isRoadSnapped

boolean

location มีการปักหมุดกับถนนหรือไม่
isGpsSensorEnabled

boolean

อินพุตเท่านั้น ระบุว่าเซ็นเซอร์ GPS เปิดใช้บนอุปกรณ์เคลื่อนที่หรือไม่
timeSinceUpdate

integer

อินพุตเท่านั้น เวลา (เป็นวินาที) นับตั้งแต่มีการส่งตำแหน่งนี้ไปยังเซิร์ฟเวอร์เป็นครั้งแรก ซึ่งจะเป็น 0 สำหรับการอัปเดตครั้งแรก หากไม่ทราบเวลา (เช่น เมื่อแอปรีสตาร์ท) ค่านี้จะรีเซ็ตเป็น 0
numStaleUpdates
(deprecated)

integer

อินพุตเท่านั้น เลิกใช้งานแล้ว: ตอนนี้ระบบใช้สัญญาณอื่นๆ เพื่อระบุว่าตำแหน่งล้าสมัยหรือไม่
rawLocation

object (LatLng)

ตำแหน่งยานพาหนะดิบ (Road-Snapper ไม่ได้ประมวลผล)
rawLocationTime

string (Timestamp format)

การประทับเวลาที่เชื่อมโยงกับตำแหน่งดิบ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่างเช่น "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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "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 หรือ 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 Location ของ Android
CORE_LOCATION ผู้ให้บริการตำแหน่งในระบบปฏิบัติการ Apple