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

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

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

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

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

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

Routes API
Distance Matrix API
  • ต้นทางหรือปลายทางสูงสุด 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 โหมดที่มีเวลาในการตอบสนองเร็วที่สุด
สภาพการจราจรแบบสดที่มีผล TRAFFIC_AWARE ไม่มีเวอร์ชันเทียบเท่า

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

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

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

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

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

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

โทรหาบริการเดียวแทน 2 บริการ

Routes API เปิดใช้บริการเพียง 1 รายการในคอนโซล 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 ที่สร้างขึ้นเพื่อกรณีการใช้งานนี้โดยเฉพาะและจะให้ผลลัพธ์ที่มีคุณภาพสูงขึ้น

โหมดการเดินทางที่ใช้ได้

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

XML เป็นรูปแบบคำตอบ

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