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

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

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

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

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

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

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

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

ตอบคำขอเร็วขึ้น

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

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

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

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

  • ข้อมูลค่าผ่านทางนอกเหนือจากระยะทางและเวลาถึงโดยประมาณ
  • เส้นทางสำหรับยานพาหนะ 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 เล็กน้อย แต่มีผลกระทบต่อคุณภาพ ETA น้อย

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

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

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

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

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

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

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

ประเภท 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

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

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

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

จุดอ้างอิงของเส้นประกอบ

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

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

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

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

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

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

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