ภาพรวม 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 to 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 เขียนคำขอที่ซับซ้อนมากขึ้น ลองส่งคำขอที่ระบุต้นทางและปลายทางหลายแห่ง ดูข้อมูลเกี่ยวกับพารามิเตอร์ที่ไม่บังคับเพื่อจำกัดการคำนวณ เช่น เวลาออกเดินทางที่ระบุ หรือข้อจำกัดของเส้นทาง ดูพารามิเตอร์ที่ไม่บังคับในคู่มือคำขอและการตอบกลับของเมทริกซ์ระยะทาง (เดิม)
4 ทำความเข้าใจข้อมูลเบื้องต้นเกี่ยวกับการตอบกลับ สำรวจการตอบกลับข้อมูลเพื่อเตรียมใช้ข้อมูลเมทริกซ์ระยะทางสำหรับแอปของคุณ ดูรายละเอียดได้ที่การตอบกลับเมทริกซ์ระยะทาง
5 รวมข้อมูลเมทริกซ์ระยะทางไว้ในแอปของคุณเอง คุณสามารถใช้ข้อมูลนี้เพื่อคำนวณระยะทางและเวลาในการเดินทางได้

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

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

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

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