Distance Matrix

DistanceMatrixService class

google.maps.DistanceMatrixService class

บริการสำหรับคำนวณระยะทางระหว่างต้นทางและปลายทางหลายแห่ง

เข้าถึงโดยการโทรหา const {DistanceMatrixService} = await google.maps.importLibrary("routes") โปรดดูไลบรารีใน Maps JavaScript API
DistanceMatrixService
DistanceMatrixService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ DistanceMatrixService ที่ส่งการค้นหาเมตริกระยะทางไปยังเซิร์ฟเวอร์ของ Google
getDistanceMatrix
getDistanceMatrix(request[, callback])
พารามิเตอร์: 
ผลลัพธ์:  Promise<DistanceMatrixResponse>
ส่งคําขอเมทริกซ์ระยะทาง

อินเทอร์เฟซ DistanceMatrixRequest

google.maps.DistanceMatrixRequest อินเทอร์เฟซ

การค้นหาเมตริกระยะทางที่ DistanceMatrixService ส่งซึ่งมีอาร์เรย์ของสถานที่ต้นทางและปลายทาง รวมถึงตัวเลือกต่างๆ สําหรับการคํานวณเมตริก
destinations
ประเภท:  Array<string|LatLng|LatLngLiteral|Place>
อาร์เรย์ที่มีสตริงที่อยู่ปลายทาง หรือออบเจ็กต์ LatLng หรือ Place เพื่อคํานวณระยะทางและเวลา ต้องระบุ
origins
ประเภท:  Array<string|LatLng|LatLngLiteral|Place>
อาร์เรย์ที่มีสตริงที่อยู่ต้นทาง หรือออบเจ็กต์ LatLng หรือ Place เพื่อคํานวณระยะทางและเวลา ต้องระบุ
travelMode
ประเภท:  TravelMode
ประเภทการกำหนดเส้นทางที่ขอ ต้องระบุ
avoidFerries optional
ประเภท:  boolean optional
หากเป็น true จะเป็นการสั่งให้บริการเมทริกซ์ระยะทางหลีกเลี่ยงเรือข้ามฟากหากเป็นไปได้ ไม่บังคับ
avoidHighways optional
ประเภท:  boolean optional
หากเป็น true จะเป็นการสั่งให้บริการเมทริกซ์ระยะทางหลีกเลี่ยงทางหลวงหากเป็นไปได้ ไม่บังคับ
avoidTolls optional
ประเภท:  boolean optional
หากเป็น true จะเป็นการสั่งให้บริการตารางระยะทางหลีกเลี่ยงถนนที่มีค่าผ่านทาง หากเป็นไปได้ ไม่บังคับ
drivingOptions optional
ประเภท:  DrivingOptions optional
การตั้งค่าที่มีผลกับคำขอที่ travelMode เป็น DRIVING เท่านั้น วัตถุนี้จะไม่มีผลกับการเดินทางด้วยวิธีอื่นๆ
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
region optional
ประเภท:  string optional
รหัสภูมิภาคที่ใช้เป็นค่ากำหนดสำหรับคำขอการแปลงพิกัดภูมิศาสตร์ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ส่วนรหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
transitOptions optional
ประเภท:  TransitOptions optional
การตั้งค่าที่มีผลกับคำขอที่ travelMode เป็น TRANSIT เท่านั้น วัตถุนี้จะไม่มีผลกับการเดินทางด้วยวิธีอื่นๆ
unitSystem optional
ประเภท:  UnitSystem optional
ระบบหน่วยที่ต้องการใช้เมื่อแสดงระยะทาง ไม่บังคับ ค่าเริ่มต้นคือเมตริก

DistanceMatrixResponse

google.maps.DistanceMatrixResponse อินเทอร์เฟซ

การตอบกลับคําขอ DistanceMatrixService ซึ่งประกอบด้วยที่อยู่ต้นทางและปลายทางที่มีการจัดรูปแบบ และลําดับ DistanceMatrixResponseRow 1 รายการสําหรับที่อยู่ต้นทางที่เกี่ยวข้องแต่ละรายการ
destinationAddresses
ประเภท:  Array<string>
ที่อยู่ปลายทางที่จัดรูปแบบแล้ว
originAddresses
ประเภท:  Array<string>
ที่อยู่ต้นทางที่จัดรูปแบบแล้ว
rows
ประเภท:  Array<DistanceMatrixResponseRow>
แถวของเมทริกซ์ที่สอดคล้องกับที่อยู่ต้นทาง

อินเทอร์เฟซ DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow อินเทอร์เฟซ

แถวของการตอบกลับคําขอ DistanceMatrixService ซึ่งประกอบด้วยลําดับ DistanceMatrixResponseElement 1 รายการสําหรับปลายทางที่เกี่ยวข้องแต่ละรายการ
elements
ประเภท:  Array<DistanceMatrixResponseElement>
องค์ประกอบของแถวที่สอดคล้องกับที่อยู่ปลายทาง

DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElement อินเทอร์เฟซ

องค์ประกอบเดียวของการตอบกลับคําขอ DistanceMatrixService ซึ่งมีระยะเวลาและระยะทางจากต้นทางหนึ่งไปยังปลายทางหนึ่ง
distance
ประเภท:  Distance
ระยะทางของคู่ต้นทาง-ปลายทางนี้ พร็อพเพอร์ตี้นี้อาจไม่มีค่า เนื่องจากระยะทางอาจไม่ทราบ
duration
ประเภท:  Duration
ระยะเวลาของคู่ต้นทาง-ปลายทางนี้ พร็อพเพอร์ตี้นี้อาจไม่มีค่า เนื่องจากอาจไม่ทราบระยะเวลา
duration_in_traffic
ประเภท:  Duration
ระยะเวลาของการจับคู่ต้นทาง-ปลายทางนี้ โดยพิจารณาจากสภาพการเข้าชมที่ระบุโดยพร็อพเพอร์ตี้ trafficModel พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากอาจไม่ทราบระยะเวลา ใช้ได้กับลูกค้าแพ็กเกจพรีเมียมเท่านั้นเมื่อมีการระบุ drivingOptions เมื่อส่งคำขอ
fare
ประเภท:  TransitFare
ค่าโดยสารทั้งหมดสำหรับการจับคู่ต้นทาง-ปลายทางนี้ ใช้ได้กับคำขอขนส่งสาธารณะเท่านั้น
status
ประเภท:  DistanceMatrixElementStatus
สถานะของการจับคู่ต้นทาง-ปลายทางนี้

DistanceMatrixStatus constants

google.maps.DistanceMatrixStatus constants

สถานะระดับบนสุดเกี่ยวกับคำขอโดยทั่วไปที่ DistanceMatrixService แสดงเมื่อคําขอเมตริกระยะทางเสร็จสมบูรณ์ ระบุค่าเหล่านี้ตามค่า หรือใช้ชื่อของค่าคงที่ เช่น 'OK' หรือ google.maps.DistanceMatrixStatus.OK

เข้าถึงโดยการโทรหา const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") โปรดดูไลบรารีใน Maps JavaScript API
INVALID_REQUEST คำขอที่ระบุไม่ถูกต้อง
MAX_DIMENSIONS_EXCEEDED คำขอมีต้นทางมากกว่า 25 แห่งหรือปลายทางมากกว่า 25 แห่ง
MAX_ELEMENTS_EXCEEDED ผลคูณของต้นทางและปลายทางเกินขีดจํากัดต่อคําค้นหา
OK การตอบกลับมีผลลัพธ์ที่ถูกต้อง
OVER_QUERY_LIMIT มีคำขอองค์ประกอบมากเกินไปภายในระยะเวลาที่อนุญาต คำขอควรสำเร็จหากคุณลองอีกครั้งในภายหลัง
REQUEST_DENIED บริการปฏิเสธการใช้บริการตารางระยะทางโดยหน้าเว็บของคุณ
UNKNOWN_ERROR ประมวลผลคำขอตารางระยะทางไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง

DistanceMatrixElementStatus constants

google.maps.DistanceMatrixElementStatus constants

สถานะระดับองค์ประกอบเกี่ยวกับการจับคู่ต้นทาง-ปลายทางที่เฉพาะเจาะจงซึ่ง DistanceMatrixService แสดงผลเมื่อคําขอเมทริกซ์ระยะทางเสร็จสมบูรณ์ ค่าเหล่านี้จะระบุเป็นสตริง เช่น 'OK'

เข้าถึงโดยการโทรหา const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") โปรดดูไลบรารีใน Maps JavaScript API
NOT_FOUND จับคู่ต้นทางและ/หรือปลายทางของคู่นี้ไม่ได้
OK การตอบกลับมีผลลัพธ์ที่ถูกต้อง
ZERO_RESULTS ไม่พบเส้นทางระหว่างต้นทางกับจุดหมาย