ข้อมูลอ้างอิงด่วนของ Routes API

Routes API เป็นเว็บเซอร์วิสที่มี 2 เมธอด ได้แก่ Compute Routes ซึ่งจะแสดงผลเส้นทางระหว่างสถานที่ 2 แห่งพร้อมจุดอ้างอิงกลาง (ไม่บังคับ) และ Compute Route Matrix ซึ่งจะแสดงผลระยะทางและเวลาในการเดินทางสำหรับชุดค่าผสมของต้นทางและปลายทาง (สูงสุด 625 องค์ประกอบเมทริกซ์เส้นทาง)

Routes API: ข้อเท็จจริงสำคัญ

  • ผลิตภัณฑ์: Routes API
  • หรือที่เรียกว่า Routes API v2, Compute Routes, Compute Route Matrix
  • หมวดหมู่: เส้นทาง
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Routes API
  • ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก การกำหนดเส้นทางสำหรับรถ 2 ล้อ เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม และการคำนวณค่าผ่านทางจะจำกัดเฉพาะประเทศและเมืองที่รองรับ และไม่รองรับเขตแดนที่ขึ้นกับประเทศอื่นซึ่งมีรหัส CLDR ของตนเอง เว้นแต่จะระบุไว้ สำหรับที่อยู่สำหรับการเรียกเก็บเงินในเขตเศรษฐกิจยุโรป (EEA) ข้อกำหนดของ EEA ที่ https://developers.google.com/maps/comms/eea/routes ห้ามใช้คำอธิบายหรือขั้นตอนของเส้นทางกับแผนที่ใดๆ (รายละเอียดความครอบคลุม)

Routes API: กรณีที่ควรใช้

ใช้ Routes API ในกรณีต่อไปนี้

  • คุณต้องมีเส้นทางระหว่างต้นทางและปลายทาง โดยมีจุดอ้างอิงกลาง (ไม่บังคับ) สำหรับการขับรถ การเดิน การปั่นจักรยาน การขับขี่รถ 2 ล้อ หรือการขนส่งสาธารณะ
  • คุณต้องการระยะทางและเวลาเดินทางสำหรับคู่ต้นทาง-ปลายทางหลายคู่ในคำขอเดียว (สูงสุด 625 องค์ประกอบ)
  • คุณต้องการค่าผ่านทางโดยประมาณ (บางเมือง) เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม (บางภูมิภาค) เส้นประกอบที่คำนึงถึงการจราจร หรือการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่ (ความพร้อมให้บริการแบบจำกัด)
  • คุณกำลังย้ายข้อมูลแอปเซิร์ฟเวอร์ออกจาก Directions API หรือ Distance Matrix API เดิม

อย่าใช้ Routes API ในกรณีต่อไปนี้

  • คุณต้องเพิ่มประสิทธิภาพการมอบหมายการบรรทุกและหยุดการสั่งซื้อสำหรับยานพาหนะทั้งกลุ่ม โปรดใช้ Route Optimization API แทน
  • คุณต้องมีการนำทางแบบเลี้ยวต่อเลี้ยวในแอปบน Android ที่เป็นไปตามเส้นทางที่คำนวณไว้ โปรดใช้ Navigation SDK สำหรับ Android แทน
  • คุณต้องการการนำทางแบบเลี้ยวต่อเลี้ยวในแอปบน iOS ที่เป็นไปตามเส้นทางที่คำนวณไว้ โปรดใช้ Navigation SDK สำหรับ iOS แทน

Routes API: การตั้งค่า

แพ็กเกจ Routes API อย่างเป็นทางการ

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • ไปที่: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

Routes API: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: ไม่มีรายการเริ่มต้นของช่องที่แสดงผล คำขอที่ไม่มีมาสก์ช่อง (ส่วนหัว X-Goog-FieldMask หรือพารามิเตอร์ $fields) จะแสดงผลเป็นข้อผิดพลาด วิธีแก้ไข: ส่งมาสก์ฟิลด์ที่แสดงช่องการตอบกลับที่ต้องการเสมอ ดู /maps/documentation/routes/choose_fields
  • ปัญหา: การใช้มาสก์ฟิลด์ไวลด์การ์ด (*) ในเวอร์ชันที่ใช้งานจริงจะเพิ่มค่าใช้จ่ายและเวลาในการตอบสนอง และค่าใช้จ่ายอาจเพิ่มขึ้นโดยไม่คาดคิดเมื่อมีการเพิ่มฟีเจอร์ขั้นสูงใหม่ๆ ลงในการตอบกลับ วิธีแก้ไข: ใช้ * ระหว่างการพัฒนาเท่านั้น ในเวอร์ชันที่ใช้งานจริง ให้ขอเฉพาะฟิลด์ที่ต้องการ ดู /maps/documentation/routes/choose_fields
  • ปัญหา: ระบบจะไม่แสดงข้อมูลค่าผ่านทางและปริมาณการใช้เชื้อเพลิงเพียงแค่เพิ่มข้อมูลดังกล่าวลงในมาสก์ฟิลด์ เนื่องจากต้องเปิดใช้อย่างชัดเจนตั้งแต่ GA วิธีแก้ไข: เพิ่มอาร์เรย์ extraComputations (เช่น TOLLS, FUEL_CONSUMPTION) ลงในคำขอนอกเหนือจากฟิลด์มาสก์ ดู /maps/documentation/routes/migrate-routes-preview
  • ปัญหา: Compute Route Matrix อนุญาตให้มีองค์ประกอบได้ 625 รายการ แต่มีได้เพียง 100 รายการเมื่อ routingPreference เป็น TRAFFIC_AWARE_OPTIMAL วิธีแก้ไข: กำหนดให้ต้นทาง x ปลายทางมีจำนวนไม่เกิน 100 เมื่อใช้ TRAFFIC_AWARE_OPTIMAL หรือแบ่งคำขอออกเป็นหลายรายการ ดู /maps/documentation/routes/compute_route_matrix

สิ่งที่คุณทำได้ด้วย Routes API

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ