Distance Matrix

คลาส DistanceMatrixService

google.maps.DistanceMatrixService ชั้นเรียน

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

เข้าถึงโดยโทรไปที่ 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 จะสั่งให้บริการ Distance Matrix หลีกเลี่ยงทางพิเศษ หากเป็นไปได้ ไม่บังคับ
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 สำหรับที่อยู่ต้นทางแต่ละรายการที่เกี่ยวข้อง
destinationAddresses
ประเภท:  Array<string>
ที่อยู่ปลายทางที่จัดรูปแบบ
originAddresses
ประเภท:  Array<string>
ที่อยู่ต้นทางที่จัดรูปแบบ
rows
ประเภท:  Array<DistanceMatrixResponseRow>
แถวของเมทริกซ์ที่สอดคล้องกับที่อยู่ต้นทาง

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

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

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

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

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

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

ค่าคงที่ DistanceMatrixStatus

ค่าคงที่ google.maps.DistanceMatrixStatus

สถานะระดับบนสุดเกี่ยวกับคำขอโดยทั่วไปที่ 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 บริการปฏิเสธการใช้บริการ Distance Matrix ในหน้าเว็บของคุณ
UNKNOWN_ERROR ประมวลผลคำขอเมทริกซ์ระยะทางไม่ได้ เนื่องจากเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง

DistanceMatrixElementStatus

ค่าคงที่ google.maps.DistanceMatrixElementStatus

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

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