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 ตามนาฬิกาของเซ็นเซอร์

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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

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

integer

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

object (LatLng)

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

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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 เป็นรัศมีเป็นเมตร
supplementalLocation

object (LatLng)

ตำแหน่งเสริมที่แอปที่ผสานรวมให้ไว้
supplementalLocationTime

string (Timestamp format)

การประทับเวลาที่เชื่อมโยงกับสถานที่เสริม

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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 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