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)

ตำแหน่งของรถดิบ (ไม่ได้ประมวลผลโดยปลากะพงบนท้องถนน)
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 Assisted 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