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,
  "flpLocation": {
    object (LatLng)
  },
  "flpUpdateTime": string,
  "flpLatlngAccuracyMeters": number,
  "flpHeadingDegrees": integer,
  "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 เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 เป็นรัศมีในหน่วยเมตร
flpLocation

object (LatLng)

ตำแหน่งจาก Fused Location Provider ของ Android
flpUpdateTime

string (Timestamp format)

การประทับเวลาของการอัปเดตของ flpLocation

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
flpLatlngAccuracyMeters

number

ความแม่นยำของ flpLocation ในหน่วยเมตรเป็นรัศมี
flpHeadingDegrees

integer

ทิศทางที่ยานพาหนะเคลื่อนที่ในหน่วยองศาตามที่กำหนดโดย Fused Location Provider 0 หมายถึงทิศเหนือ ช่วงที่ใช้ได้คือ [0,360)
supplementalLocation

object (LatLng)

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

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 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 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 Provider ของ Android
CORE_LOCATION ผู้ให้บริการตำแหน่งในระบบปฏิบัติการของ Apple