Package google.maps.navconnect.v1

ดัชนี

• NavConnectService (อินเทอร์เฟซ)
• AuthToken (ข้อความ)
• CreateTripRequest (ข้อความ)
• GetTripRequest (ข้อความ)
• Location (ข้อความ)
• Stop (ข้อความ)
• Trip (ข้อความ)
• Trip.State (enum)
• TripConfig (ข้อความ)
• TripExecution (ข้อความ)

NavConnectService

บริการสำหรับลูกค้า NavConnect ในการสร้างและรับการเดินทาง

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) สร้างการเดินทาง ต้องเรียกใช้ก่อนที่แอปพลิเคชันบนอุปกรณ์เคลื่อนที่จะเริ่มการเดินทางได้ การเดินทางที่ส่งคืนจะมีฟิลด์ auth_token ตั้งค่าไว้ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/cloud-platform

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) รับการเดินทาง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/cloud-platform

AuthToken

โทเค็นการตรวจสอบสิทธิ์

ช่อง
token	string เอาต์พุตเท่านั้น โทเค็นการตรวจสอบสิทธิ์ที่ควรส่งไปยังแอปพลิเคชันบนอุปกรณ์เคลื่อนที่
expire_time	Timestamp เอาต์พุตเท่านั้น เวลาที่โทเค็นการตรวจสอบสิทธิ์จะหมดอายุ

CreateTripRequest

ข้อความคำขอสำหรับ NavConnectService.CreateTrip

ช่อง
parent	string ต้องระบุ ทรัพยากรระดับบนสุดที่จะสร้างการเดินทางนี้ รูปแบบ: projects/{project_number}
trip_id	string ต้องระบุ รหัสที่จะใช้สำหรับการเดินทาง ซึ่งจะกลายเป็นคอมโพเนนต์สุดท้ายของชื่อทรัพยากรของการเดินทาง ค่านี้ต้องเป็น UUID ของ RFC-4122 ที่ถูกต้อง
trip	Trip ต้องระบุ การเดินทางที่จะสร้าง

GetTripRequest

ข้อความคำขอสำหรับ NavConnectService.GetTrip

ช่อง
name	string ต้องระบุ ชื่อทรัพยากรของการเดินทางที่จะรับ รูปแบบ: projects/{project}/trips/{trip_id}

ตำแหน่ง

ตำแหน่งตามที่แอปพลิเคชันบนอุปกรณ์เคลื่อนที่รายงาน

ช่อง
point	LatLng เอาต์พุตเท่านั้น ละติจูด/ลองจิจูดของสถานที่
source_time	Timestamp เอาต์พุตเท่านั้น เวลาที่ได้แหล่งที่มาของสถานที่ตามที่ไคลเอ็นต์ระบุ
server_time	Timestamp เอาต์พุตเท่านั้น เวลาที่เซิร์ฟเวอร์ได้รับการอัปเดตตำแหน่งนี้

หยุด

จุดแวะพักในการเดินทางซึ่งต้องดำเนินงานบางอย่าง

ช่อง
point	LatLng ต้องระบุ ตำแหน่งของป้ายจอดรถเป็นละติจูด/ลองจิจูด

การเดินทาง

การเดินทาง

ช่อง
name	string เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรของการเดินทาง รูปแบบ: projects/{project_number}/trips/{trip_id}
config	TripConfig เปลี่ยนแปลงไม่ได้ การกำหนดค่าสำหรับการเดินทาง
android_app_id	string อินพุตเท่านั้น เปลี่ยนแปลงไม่ได้ รหัสแอปพลิเคชัน Android ของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่จะใช้การเดินทาง ต้องตั้งค่า android_app_id หรือ ios_app_id อย่างน้อย 1 รายการ
ios_app_id	string อินพุตเท่านั้น เปลี่ยนแปลงไม่ได้ รหัสชุด iOS ของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่จะใช้การเดินทาง ต้องตั้งค่า android_app_id หรือ ios_app_id อย่างน้อย 1 รายการ
auth_token	AuthToken เอาต์พุตเท่านั้น โทเค็นแบบทึบแสงที่ให้สิทธิ์เข้าถึงเพื่อเริ่มการเดินทาง NavConnect ใน Google Maps หรือ Waze และให้สิทธิ์แอปพลิเคชันเหล่านี้ในการอัปเดตการเดินทาง CreateTrip เท่านั้นที่ส่งคืน
state	State เอาต์พุตเท่านั้น สถานะการเดินทาง
execution	TripExecution เอาต์พุตเท่านั้น ข้อมูลล่าสุดเกี่ยวกับการเดินทาง ระบบอาจไม่ได้ตั้งค่านี้หากการเดินทางอยู่ในสถานะข้อผิดพลาด
create_time	Timestamp เอาต์พุตเท่านั้น เวลาตามเซิร์ฟเวอร์เมื่อสร้างการเดินทาง
update_time	Timestamp เอาต์พุตเท่านั้น เวลาที่เซิร์ฟเวอร์ได้รับการอัปเดตการเดินทางล่าสุด

รัฐ

สถานะการเดินทางที่เป็นไปได้ทั้งหมด

Enum
STATE_UNSPECIFIED	ไม่ได้ระบุสถานะการเดินทาง
NEW	ระบบสร้างการเดินทางแล้ว แต่ยังไม่ได้เริ่ม
ENROUTE	ผู้ขนส่งกำลังเดินทางไปยังจุดหมาย
ARRIVED	ผู้ขนส่งมาถึงจุดหมายแล้ว
SUSPENDED	การเดินทางถูกระงับ
FAILED	การเดินทางไม่สำเร็จ
CLIENT_ERROR	การเดินทางล้มเหลวเนื่องจากข้อผิดพลาดเกี่ยวกับไคลเอ็นต์

TripConfig

การกำหนดค่าสำหรับการเดินทาง

ช่อง
enable_high_frequency_updates	bool ไม่บังคับ จะเปิดใช้การอัปเดตการเดินทางที่มีความถี่สูงหรือไม่ หมายเหตุ: การเปิดใช้ฟีเจอร์นี้จะบันทึกการเดินทางภายใต้การใช้งานระดับองค์กร และมีอัตราค่าบริการระดับองค์กร
enable_pubsub	bool ไม่บังคับ จะเปิดใช้การแจ้งเตือน Pub/Sub สำหรับการเดินทางหรือไม่
pubsub_field_mask	FieldMask ไม่บังคับ หากตั้งค่าไว้ ระบบจะรวมเฉพาะฟิลด์การเดินทางที่ระบุไว้ในชุดย่อยในการแจ้งเตือน Pub/Sub หากไม่ได้ตั้งค่า ระบบจะรวมช่องการเดินทางทั้งหมดไว้ในการแจ้งเตือน Pub/Sub (ลักษณะการทำงานเริ่มต้น) ระบบไม่รองรับฟิลด์ต่อไปนี้ android_app_id ios_app_id auth_token config หมายเหตุ: ระบบจะไม่สนใจฟิลด์นี้หาก enable_pubsub เป็นเท็จ

TripExecution

ข้อมูลเกี่ยวกับการเดินทาง

ช่อง
origin	Location เอาต์พุตเท่านั้น ต้นทางการเดินทาง ซึ่งโดยทั่วไปคือตำแหน่งของผู้ให้บริการขนส่งเมื่อเริ่มการเดินทางของ NavConnect
destination	Stop เอาต์พุตเท่านั้น จุดหมายของการเดินทางตามที่แอปพลิเคชันบนอุปกรณ์เคลื่อนที่รายงาน
location	Location เอาต์พุตเท่านั้น สัญญาณตำแหน่งที่แสดงตำแหน่งสุดท้ายที่ทราบของผู้ให้บริการขนส่ง ซึ่งจะเป็นตำแหน่งที่สแนปถนนหากมี
traveled_duration	Duration เอาต์พุตเท่านั้น เวลาที่เดินทางจนถึงตอนนี้
remaining_duration	Duration เอาต์พุตเท่านั้น เวลาที่เหลือในการเดินทางนี้ตามที่ Google ประมาณ
traveled_distance_meters	int32 เอาต์พุตเท่านั้น ระยะทางที่เดินทางจากต้นทางเป็นเมตร
remaining_distance_meters	int32 เอาต์พุตเท่านั้น ระยะทางที่เหลือไปยังจุดหมายเป็นเมตร
stop_added_in_route	bool เอาต์พุตเท่านั้น ระบุว่ามีการเพิ่มจุดแวะระหว่างเส้นทางหรือไม่