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

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

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

สำหรับ Compute Route Matrix จำนวนองค์ประกอบในคำขอ (จำนวนต้นทาง × จำนวนปลายทาง) ต้องไม่เกิน 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
การจราจรไม่ทราบเวลาถึงโดยประมาณ โดยไม่คำนึงถึงเวลา

ตั้งค่าโดยใช้ 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 ที่สร้างขึ้นสำหรับกรณีการใช้งานนี้และให้ผลลัพธ์ที่มีคุณภาพสูงขึ้น

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

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

XML เป็นรูปแบบการตอบสนอง

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