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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

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

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

ส่วนนี้ครอบคลุมการปรับปรุงบางอย่างที่คุณคาดหวังได้เมื่อใช้ Routes API ในแอป

ขีดจำกัดคำขอที่เพิ่มขึ้น

Routes API Compute Route Matrix
Distance Matrix API
  • ต้นทางหรือปลายทางสูงสุด 25 รายการต่อคำขอ
  • สูงสุด 100 องค์ประกอบ (จำนวนต้นทาง × จำนวนปลายทาง) ต่อ คำขอฝั่งเซิร์ฟเวอร์

การตอบกลับคำขอที่เร็วขึ้น

ฟีเจอร์ Compute Route Matrix มีการปรับปรุงเวลาในการตอบสนองดังต่อไปนี้

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

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

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

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

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

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

Routes API
Compute Routes
Compute Route Matrix 		คำขอต้องใช้มาสก์ของฟิลด์เพื่อระบุฟิลด์ที่ต้องการให้แสดงผลในการตอบกลับ การใช้มาสก์ของฟิลด์ช่วยให้คุณไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและค่าบริการที่ไม่จำเป็น
ดูข้อมูลเพิ่มเติมได้ที่ เลือกฟิลด์ที่จะแสดงผล
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 เล็กน้อย แต่มีคุณภาพเวลาถึงโดยประมาณที่ต่ำกว่าเล็กน้อย

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

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

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

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

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

เรียกใช้บริการเดียวแทนที่จะเป็น 2 บริการ

Routes API เปิดใช้บริการเดียวในคอนโซล API เพื่อให้แอปใช้ Compute Routes และ Compute Route Matrix ได้
ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าใน คอนโซล Google API
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
เวลาถึงโดยประมาณที่ไม่ขึ้นกับเวลาและไม่คำนึงถึงข้อมูลการจราจร

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

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

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

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

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

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

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

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

จุดแวะพักแบบเส้นประกอบ

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

ที่อยู่ที่จัดรูปแบบแล้ว (การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ)

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

โหมดการเดินทางที่พร้อมให้บริการ

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

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

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