ภาพรวม Distance Matrix API (เดิม)

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

บทนำ

Distance Matrix API (Legacy) เป็นบริการที่รับคำขอ HTTPS ที่มีต้นทางและปลายทางสำหรับการขนส่งโหมดหนึ่งๆ โดยจะแสดงระยะทางและระยะเวลาการเดินทางสำหรับการผสมผสานต้นทางและปลายทางแต่ละรายการ

เหตุใดจึงต้องใช้ Distance Matrix API (Legacy)

คุณสามารถใช้ Distance Matrix API (Legacy) เพื่อช่วยกำหนดเส้นทางการเดินทางที่มีประสิทธิภาพมากที่สุดระหว่างต้นทางและปลายทางที่เป็นไปได้หลายแห่ง เช่น จะส่งพนักงานคนใดไปยังไซต์งาน หรือจะส่งพัสดุจากคลังสินค้าใด

สิ่งที่คุณทำได้ด้วย Distance Matrix API (Legacy)

Distance Matrix API (Legacy) ช่วยให้คุณระบุระยะทางและเวลาการเดินทางสำหรับเมทริกซ์ของต้นทางและปลายทางได้ คุณสามารถระบุตัวเลือกต่างๆ ได้ รวมถึงโหมดการขนส่ง เช่น การขับรถ การปั่นจักรยาน การขนส่งสาธารณะ หรือการเดิน รวมถึงโหมดโดยสาร เช่น รถประจำทาง รถไฟใต้ดิน รถไฟ รถราง หรือรถไฟ

Distance Matrix API (Legacy) จะให้ข้อมูลตามเส้นทางที่แนะนำระหว่างจุดเริ่มต้นและจุดสิ้นสุด คุณสามารถขอข้อมูลระยะทางประเภทต่อไปนี้ได้

  • ระยะทางสำหรับโหมดการเดินทางที่เลือก
  • ระยะทางเป็นกิโลเมตรหรือไมล์
  • ระยะเวลาเดินทางโดยประมาณในสภาพการจราจร

แผนที่แสดงต้นทางและปลายทางบนแผนที่และในการตอบกลับจาก API

วิธีการทำงานของ Distance Matrix API (Legacy)

Distance Matrix API (Legacy) ใช้ต้นทาง (จุดเริ่มต้น) และปลายทางจำนวนเท่าใดก็ได้ และแสดงระยะทางและระยะเวลาเดินทางระหว่างต้นทางแต่ละแห่งกับปลายทางที่ขอทั้งหมด โดยเริ่มจากต้นทางแรกในคำขอและดำเนินการทีละขั้นตอนไปยังต้นทางถัดไป

ตัวอย่างเช่น หากคำขอระบุ A และ B เป็นต้นทาง และ C และ D เป็นปลายทาง ระบบจะแสดงระยะทางและระยะเวลาเดินทางตามลำดับต่อไปนี้

  • A ไป C
  • A ไป D
  • B ไป C
  • B ไป D

ตัวอย่างต่อไปนี้แสดงคำขอสำหรับต้นทาง 2 แห่ง ได้แก่ วอชิงตัน ดี.ซี. และบอสตัน โดยมีปลายทางเดียวคือ นครนิวยอร์ก รัฐนิวยอร์ก ในรูปแบบ JSON

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

แหล่งข้อมูล

ตารางต่อไปนี้สรุปแหล่งข้อมูลที่พร้อมใช้งานผ่าน Distance Matrix API (Legacy) พร้อมกับข้อมูลที่แสดงผล

แหล่งข้อมูล ข้อมูลที่แสดงผล รูปแบบการแสดงผล
เมทริกซ์ระยะทาง

ระบุต้นทางและปลายทางในรูปแบบรหัสสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูด

  • ระยะทางและระยะเวลาเดินทางระหว่างต้นทางแต่ละแห่งกับปลายทางแต่ละแห่ง
  • ระยะเวลาในสภาพการจราจรหากคุณระบุโหมดขับรถและเวลาออกเดินทาง
  • JSON
  • XML

วิธีใช้ Distance Matrix API (Legacy)

1 ตั้งค่า เริ่มต้นด้วยการตั้งค่า โปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่า ที่ตามมา
2 ลองส่งคำขอเมทริกซ์ระยะทาง เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Distance Matrix API (Legacy) ได้โดยตรงจากเบราว์เซอร์ ดูตัวอย่างได้ในส่วนตัวอย่างคำขอ ในคู่มือเริ่มต้นใช้งาน
3 สร้างคำขอที่ซับซ้อนมากขึ้น ลองส่งคำขอที่ระบุต้นทางและปลายทางหลายแห่ง ดูข้อมูลเกี่ยวกับพารามิเตอร์ที่ไม่บังคับเพื่อจำกัดการคำนวณ เช่น เวลาออกเดินทางที่ระบุ หรือข้อจำกัดของเส้นทาง ดู พารามิเตอร์ที่ไม่บังคับ ในคู่มือ คำขอและการตอบกลับของเมทริกซ์ระยะทาง (เดิม)
4 ทำความเข้าใจข้อมูลพื้นฐานเกี่ยวกับการตอบกลับ สำรวจการตอบกลับข้อมูลเพื่อเตรียมพร้อมใช้ข้อมูลเมทริกซ์ระยะทางสำหรับแอป ดูรายละเอียดได้ที่ การตอบกลับของเมทริกซ์ระยะทาง
5 รวมข้อมูลเมทริกซ์ระยะทางไว้ในแอปของคุณเอง คุณสามารถใช้ข้อมูลนี้เพื่อคำนวณระยะทางและเวลาการเดินทางได้

ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน

เรียก API นี้ในภาษาที่คุณเลือกผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้

Java Client, Python Client, Go Client และ Node.js Client for Google Maps Services เป็นไลบรารีของไคลเอ็นต์ที่ชุมชนให้การสนับสนุน ซึ่งเป็นโอเพนซอร์สภายใต้ Apache 2.0 License ดาวน์โหลดได้จาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและโค้ดตัวอย่างได้ด้วย

ขั้นตอนถัดไป