Package google.maps.routes.v1alpha

ดัชนี

RoutesAlpha

Routes Preferred API

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

การคำนวณเส้นทางที่ดีที่สุดสำหรับวัตถุประสงค์ของเส้นทางโดยใช้ชุดของจุดสิ้นสุดและจุดระหว่างทาง และวัตถุประสงค์ของเส้นทาง รวมทั้งแสดงเส้นทางที่เร็วที่สุดและเส้นทางที่สั้นที่สุดเป็นเส้นทางอ้างอิง

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม

ตัวอย่างเช่น ในวิธีการนี้

  • มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: *
  • ฟิลด์มาสก์ของระยะทาง ระยะเวลา โทเค็น และข้อมูลค่าผ่านทาง: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) หรือระบุมาสก์ช่องที่ระดับบนสุด (routes) เนื่องจากสาเหตุต่อไปนี้

  • การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง
  • การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/maps-platform.routespreferred

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

นำรายการต้นทางและปลายทางกลับมา แล้วแสดงผลสตรีมที่มีข้อมูลเส้นทางสำหรับชุดค่าผสมต้นทางและปลายทางแต่ละรายการ

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม

ตัวอย่างเช่น ในวิธีการนี้

  • มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: *
  • มาสก์ของช่องของระยะเวลาเส้นทาง ระยะทาง สถานะองค์ประกอบ เงื่อนไข และดัชนีองค์ประกอบ (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

คุณจำเป็นต้องใส่ status ในมาสก์ของช่อง ไม่เช่นนั้นข้อความทั้งหมดจะไม่มีปัญหา Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) เนื่องจาก

  • การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง
  • การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/maps-platform.routespreferred

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

แสดงเส้นทางหลักพร้อมกับเส้นทางสำรองที่เป็นตัวเลือก โดยพิจารณาจากชุดของจุดสิ้นสุดและจุดระหว่างทาง

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม

ตัวอย่างเช่น ในวิธีการนี้

  • มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: *
  • มาสก์ของช่องของระยะเวลา ระยะทาง และโพลีไลน์ในระดับเส้นทาง (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) หรือระบุมาสก์ช่องที่ระดับบนสุด (routes) เนื่องจากสาเหตุต่อไปนี้

  • การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง
  • การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/maps-platform.routespreferred

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0