เหตุผลที่ควรย้ายข้อมูลไปยัง Routes API

Routes API ให้ประสิทธิภาพที่ดีขึ้นในการคำนวณเส้นทาง ระยะทาง และเวลาในการเดินทาง ซึ่งทำให้คุ้มค่าที่จะเปลี่ยนแอปที่ใช้ Directions API และ Distance Matrix API ในปัจจุบันแทน ฟังก์ชันการทำงานส่วนใหญ่ของ Routes API จะเข้ากันได้กับทั้ง Directions API และ Distance Matrix API

ใช้คู่มือนี้เพื่อทําความเข้าใจความแตกต่างสําคัญใน Routes API โดยเปรียบเทียบกับผลิตภัณฑ์ที่จะแทนที่ รวมถึงวิธีจัดการการเปลี่ยนแปลงที่จําเป็น ดูรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์อื่นๆ ของ Routes API ได้ที่ภาพรวมผลิตภัณฑ์

การปรับปรุงที่สำคัญ

ส่วนนี้กล่าวถึงการเพิ่มประสิทธิภาพบางอย่างที่คุณอาจได้รับเมื่อใช้ Routes API ในแอป

เพิ่มขีดจำกัดคำขอ

Routes API
  • องค์ประกอบสูงสุด 625 รายการ เว้นแต่คุณจะระบุ TRAFFIC_AWARE_OPTIMAL
  • องค์ประกอบสูงสุด 100 รายการที่มี TRAFFIC_AWARE_OPTIMAL โปรดดูค่ากำหนดการกำหนดเส้นทางขั้นสูง
  • จุดอ้างอิงสูงสุด 50 จุด (ต้นทาง + ปลายทาง) โดยใช้รหัสสถานที่
API เมทริกซ์ระยะทาง
  • ต้นทางสูงสุด 25 แห่งหรือ 25 ปลายทางต่อคำขอ
  • องค์ประกอบสูงสุด 100 รายการ (จำนวนต้นทาง × จำนวนปลายทาง) ต่อคำขอฝั่งเซิร์ฟเวอร์

ขอให้ตอบกลับได้เร็วขึ้น

ฟีเจอร์เมทริกซ์เส้นทางการประมวลผลมีการปรับปรุงเวลาในการตอบสนองดังต่อไปนี้

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

การปรับปรุงการกำหนดเส้นทาง

ฟีเจอร์เส้นทางการประมวลผลมีการปรับปรุงการกำหนดเส้นทางดังต่อไปนี้

  • ข้อมูลค่าผ่านทางนอกเหนือจากระยะทางและเวลาถึงโดยประมาณ
  • เส้นทางสำหรับยานพาหนะ 2 ล้อ
  • ตรวจสอบจุดอ้างอิงจุดแวะพักเพื่อความปลอดภัย
  • เพิ่มความแม่นยำของเวลาถึงโดยประมาณด้วยการกำหนดทิศทางการเดินทางและด้านข้างของถนนสำหรับจุดอ้างอิง

ขอเฉพาะข้อมูลที่คุณต้องการ

ตอนนี้คุณสามารถระบุช่องที่จะแสดงผล ซึ่งช่วยลดเวลาในการดำเนินการและการเรียกเก็บเงิน

Routes API คำขอของคุณต้องใช้มาสก์ช่องเพื่อระบุช่องที่คุณต้องการให้แสดงในคำตอบ การมาสก์ช่องช่วยให้มั่นใจได้ว่าคุณไม่ได้ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเลือกช่องที่จะส่งคืน
Directions API
Distance Matrix API 		แสดงรายการช่องเริ่มต้นแม้ว่าแอปของคุณจะไม่ได้ต้องการช่องดังกล่าวอย่างเคร่งครัดก็ตาม ซึ่งส่งผลให้ใช้เวลาดำเนินการและการเรียกเก็บเงินที่ไม่จำเป็น

การคำนวณเส้นทางที่ได้รับการปรับปรุงสำหรับการจราจร

Routes API รองรับค่ากำหนดการกำหนดเส้นทาง 3 แบบที่คุณสามารถใช้เพื่อสร้างความสมดุลระหว่างเวลาในการตอบสนองกับคุณภาพข้อมูลเมื่อขอข้อมูลการรับส่งข้อมูล

ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าคุณภาพเทียบกับเวลาในการตอบสนอง

TRAFFIC_UNAWARE
(ค่าเริ่มต้น)		 ใช้ข้อมูลการจราจรของข้อมูลที่อิงตามเวลาโดยเฉลี่ย ไม่ใช่ข้อมูลการจราจรแบบสด ในการคำนวณเส้นทาง ซึ่งทำให้เวลาในการตอบสนองต่ำที่สุด การตั้งค่านี้เทียบเท่ากับเมื่อไม่มีการใช้การรับส่งข้อมูลใน Directions API และ Distance Matrix API
TRAFFIC_AWARE
(ใหม่)		 คุณภาพการเข้าชมแบบสดที่เพิ่มประสิทธิภาพแล้วเพื่อลดเวลาในการตอบสนอง การตั้งค่านี้จะใช้การเพิ่มประสิทธิภาพเพื่อลดเวลาในการตอบสนองลงได้อย่างมาก ต่างจาก TRAFFIC_AWARE_OPTIMAL การตั้งค่านี้ยังใหม่สำหรับ Routes API ที่ไม่มีส่วนเทียบเท่าใน Directions API หรือ Distance Matrix API ด้วย
TRAFFIC_AWARE_OPTIMAL ข้อมูลการเข้าชมที่มีคุณภาพสูงและครอบคลุม การตั้งค่านี้จะสร้างเวลาในการตอบสนองสูงสุดและเทียบเท่ากับการตั้งค่า departure_time ใน Directions API และ Distance Matrix API
ค่ากำหนดนี้เทียบเท่ากับโหมดที่ maps.google.com และในแอป Google Maps บนอุปกรณ์เคลื่อนที่ใช้

การเปรียบเทียบการคำนวณเส้นทาง

ตารางต่อไปนี้จะเปรียบเทียบตัวเลือกการกำหนดเส้นทางระหว่างบริการ Routes API กับ Directions API และ Distance Matrix API

ตัวเลือกการจราจร Routes API Directions API
Distance Matrix API		 ตอบสนองช้า
ไม่มีการจราจรแบบเรียลไทม์ TRAFFIC_UNAWARE ไม่ได้ตั้งค่าพร็อพเพอร์ตี้ departure_time รายการ เวลาในการตอบสนองที่เร็วที่สุดจาก 3 โหมด
ใช้สภาพการจราจรแบบเรียลไทม์แล้ว TRAFFIC_AWARE ไม่มีเวอร์ชันเทียบเท่า

โหมดใหม่ที่เพิ่มโดย Routes API โดยให้เวลาในการตอบสนองที่มากกว่า TRAFFIC_UNAWARE เล็กน้อย แต่คุณภาพของ ETA มีต้นทุนต่ำ

ซึ่งมีเวลาในการตอบสนองต่ำกว่า TRAFFIC_AWARE_OPTIMAL มาก
ใช้ข้อมูลการเข้าชมแบบสดที่มีคุณภาพสูงและครอบคลุม TRAFFIC_AWARE_OPTIMAL ชุดพร็อพเพอร์ตี้ departure_time ชุด

เทียบเท่ากับโหมดที่ maps.google.com และแอป Google Maps บนอุปกรณ์เคลื่อนที่ใช้

สำหรับเมทริกซ์เส้นทาง Compute จำนวนองค์ประกอบในคำขอ (จำนวนต้นทาง × จำนวนปลายทาง) ต้องไม่เกิน 100

ความแตกต่างสำคัญ

ส่วนนี้จะครอบคลุมความแตกต่างที่สำคัญระหว่าง Routes API กับบริการที่ใช้แทน รวมถึงวิธีจัดการความแตกต่างเหล่านี้เมื่อย้ายข้อมูลจากบริการเหล่านี้ในแอปที่มีอยู่

เรียกใช้บริการเดียวแทนสองบริการ

Routes API เปิดใช้เพียงบริการเดียวในคอนโซล API เพื่อให้แอปใช้ Compute Routes และ Compute Route Matrix
ดูข้อมูลเพิ่มเติมได้ที่การตั้งค่าใน Google API Console
Directions API
Distance Matrix API 		เปิดใช้บริการ 2 รายการ ได้แก่ Directions API และ Distance Matrix API เป็นบริการแยกต่างหากในคอนโซล API

ใช้คำขอ HTTPS POST รายการ

Routes API ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST
ดูตัวอย่างได้ที่
- คำนวณเส้นทาง
- คำนวณเมทริกซ์เส้นทาง
Directions API
Distance Matrix API 		ส่งพารามิเตอร์ของ URL โดยใช้คำขอ HTTP GET

ความแตกต่างของการตอบกลับเวลาถึงโดยประมาณ

Routes API จะแสดงเวลาถึงโดยประมาณและใช้พร็อพเพอร์ตี้การตอบกลับ duration ต่างจากบริการ Directions API และ Distance Matrix API ดังที่แสดงในตารางด้านล่าง

ประเภทเวลาถึงโดยประมาณ Routes API Directions API
Distance Matrix API
การจราจรไม่ทราบเวลา ETA ไม่ขึ้นอยู่กับเวลา

ตั้งค่าโดยใช้ TRAFFIC_UNAWARE

  • เวลาถึงโดยประมาณอยู่ในพร็อพเพอร์ตี้การตอบกลับ duration
  • พร็อพเพอร์ตี้การตอบกลับ duration และ staticDuration มีค่าเดียวกัน

สอดคล้องกับ departure_time ที่ไม่ได้ตั้งค่าในคำขอ

  • เวลาถึงโดยประมาณอยู่ในพร็อพเพอร์ตี้การตอบกลับ duration
  • ไม่มีการส่งกลับพร็อพเพอร์ตี้การตอบกลับ duration_in_traffic
เวลาถึงโดยประมาณจะพิจารณาการเข้าชมแบบเรียลไทม์

ตั้งค่าโดยใช้ TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL

  • ETA ที่ต้องพิจารณาการเข้าชมแบบเรียลไทม์มีอยู่ในพร็อพเพอร์ตี้การตอบสนอง duration
  • พร็อพเพอร์ตี้การตอบสนอง staticDuration ประกอบด้วยระยะเวลาในการเดินทางไปตามเส้นทางโดยไม่พิจารณาสภาพการจราจร
  • ไม่มีการแสดงผลพร็อพเพอร์ตี้ duration_in_traffic แล้ว

ตั้งค่าโดยใช้ departure_time ในคำขอ

  • ETA ที่ต้องพิจารณาการเข้าชมแบบเรียลไทม์มีอยู่ในพร็อพเพอร์ตี้การตอบสนอง duration_in_traffic

จุดอ้างอิงโพลีไลน์

คุณไม่จำเป็นต้องแปลงพิกัดละติจูด/ลองจิจูดเป็นจุดอ้างอิงโพลีไลน์สำหรับบริการนี้ ซึ่งรองรับเนื้อความของคำขอ POST และจะไม่ได้รับผลกระทบจากขีดจำกัดของสตริง URL อีกต่อไป ผู้ใช้ Distance Matrix API บางรายแก้ปัญหาขีดจำกัดของคำขอด้วยการแปลงจุดละติจูด/ลองจิจูดเป็นจุดอ้างอิงโพลีไลน์

ที่อยู่ที่จัดรูปแบบ (รหัสพิกัดแบบย้อนกลับ)

Routes API ไม่ได้ระบุที่อยู่ที่จัดรูปแบบในการตอบกลับ หากต้องการที่อยู่ที่จัดรูปแบบ ให้ใช้ Geocoding API ที่สร้างขึ้นสำหรับ กรณีการใช้งานนี้ และให้ผลลัพธ์ที่มีคุณภาพสูงขึ้น

รูปแบบการเดินทางที่มีให้บริการ

Routes API จะใช้ไดรฟ์เป็นโหมดเริ่มต้นเมื่อคําขอเส้นทางไม่ได้ระบุวิธีการเดินทาง เช่นเดียวกับในกรณีของ Directions API อย่างไรก็ตาม เมื่อคำขอระบุโหมดการเดินทางสำหรับเส้นทาง Routes API จะไม่แสดงผลอาร์เรย์ของโหมดการเดินทางที่ใช้ได้เป็นทางเลือกอื่นสำหรับคำขอดังกล่าว หากกรณีการใช้งานของคุณใช้ฟีเจอร์นี้ ให้แจ้งปัญหาโดยอธิบายวิธีที่คุณใช้ฟีเจอร์นี้เพื่อที่เราจะได้ติดตามผล

XML เป็นรูปแบบการตอบกลับ

Routes API ไม่ได้ให้ XML เป็นรูปแบบการตอบกลับ คุณสามารถค้นหาเครื่องมือแปลง JSON เป็น XML จำนวนหนึ่งทางออนไลน์ซึ่งเหมาะกับวัตถุประสงค์ของคุณ