DeliveryVehicleLocation

ตำแหน่ง ความเร็ว และการมุ่งหน้าของรถในช่วงเวลาใดเวลาหนึ่ง

การแสดง 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 (DeliveryVehicleLocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (DeliveryVehicleLocationSensor),
  "rawLocationAccuracy": number,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (DeliveryVehicleLocationSensor),
  "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 (DeliveryVehicleLocationSensor)

ผู้ให้บริการข้อมูลตำแหน่ง (เช่น 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 (DeliveryVehicleLocationSensor)

แหล่งที่มาของตำแหน่งดิบ ค่าเริ่มต้นคือ 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 (DeliveryVehicleLocationSensor)

แหล่งที่มาของสถานที่เสริม ค่าเริ่มต้นคือ CUSTOMER_SUPPLIED_LOCATION

supplementalLocationAccuracy

number

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

roadSnapped
(deprecated)

boolean

เลิกใช้งานแล้ว: ใช้ isRoadSnapped แทน

DeliveryVehicleLocationSensor

เซ็นเซอร์หรือวิธีการที่ใช้ระบุตำแหน่ง

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 ของ DeliveryVehicle
FLEET_ENGINE_LOCATION ตำแหน่งที่คำนวณโดย Fleet Engine โดยพิจารณาจากสัญญาณที่มี เอาต์พุตเท่านั้น ระบบจะปฏิเสธค่านี้หากได้รับในคำขอ
FUSED_LOCATION_PROVIDER Fused Location Provider ของ Android
CORE_LOCATION ผู้ให้บริการตำแหน่งในระบบปฏิบัติการ Apple