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

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

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

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

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

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

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

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

การตอบสนองต่อคำขอที่รวดเร็วขึ้น

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

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

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

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

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

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

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

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

ความแตกต่างของการตอบกลับ ETA

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

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

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

  • ETA ที่อยู่ในพร็อพเพอร์ตี้การตอบกลับ duration
  • พร็อพเพอร์ตี้การตอบกลับ duration และ staticDuration มีค่าเดียวกัน

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

  • ETA ที่อยู่ในพร็อพเพอร์ตี้การตอบกลับ 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 ซึ่งสร้างขึ้นสำหรับ Use Case นี้และให้ผลลัพธ์ที่มีคุณภาพสูงกว่า

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

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

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

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