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

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

บทนำ

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

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

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

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

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

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

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

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

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

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

ตัวอย่างเช่น หากคำขอระบุ 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 (เดิม) พร้อมกับข้อมูลที่ส่งคืน

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

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

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

วิธีใช้ Distance Matrix API (เดิม)

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

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

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

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

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