Distance Matrix

DistanceMatrixService class

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 จะสั่งให้บริการ Distance Matrix หลีกเลี่ยงเรือข้ามฟากหากเป็นไปได้ ไม่บังคับ
avoidHighways optional
ประเภท:  boolean optional
หาก true ให้บริการ Distance Matrix หลีกเลี่ยงทางหลวงได้ ไม่บังคับ
avoidTolls optional
ประเภท:  boolean optional
หาก true จะสั่งให้บริการ Distance Matrix หลีกเลี่ยงถนนที่มีค่าผ่านทางหากเป็นไปได้ ไม่บังคับ
drivingOptions optional
ประเภท:  DrivingOptions optional
การตั้งค่าที่มีผลกับคำขอที่ travelMode เป็น DRIVING เท่านั้น ออบเจ็กต์นี้จะไม่มีผลกับโหมดการเดินทางอื่นๆ
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
region optional
ประเภท:  string optional
รหัสภูมิภาคที่ใช้เป็นค่าอคติสำหรับคำขอ Geocoding รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") ที่มีอักขระ 2 ตัว รหัส 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 รายการ โดยมี 1 รายการสำหรับที่อยู่ปลายทางที่เกี่ยวข้องแต่ละรายการ
elements
ประเภท:  Array<DistanceMatrixResponseElement>
องค์ประกอบของแถวที่สอดคล้องกับที่อยู่ปลายทาง

DistanceMatrixResponseElement interface

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

องค์ประกอบเดียวของการตอบกลับคำขอ DistanceMatrixService ซึ่งมีระยะเวลาและระยะทางจากต้นทางหนึ่งไปยังปลายทางหนึ่ง
distance
ประเภท:  Distance
ระยะทางสำหรับการจับคู่ต้นทาง-ปลายทางนี้ พร็อพเพอร์ตี้นี้อาจไม่ได้กำหนดไว้เนื่องจากอาจไม่ทราบระยะทาง
duration
ประเภท:  Duration
ระยะเวลาสำหรับการจับคู่ต้นทาง-ปลายทางนี้ พร็อพเพอร์ตี้นี้อาจไม่ได้กำหนดไว้เนื่องจากอาจไม่ทราบระยะเวลา
duration_in_traffic
ประเภท:  Duration
ระยะเวลาสำหรับการจับคู่ต้นทาง-ปลายทางนี้ โดยคำนึงถึงสภาพการจราจรที่ระบุโดยtrafficModelพร็อพเพอร์ตี้ พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากอาจไม่ทราบระยะเวลา ใช้ได้กับลูกค้าแพ็กเกจ Premium เท่านั้นเมื่อมีการกำหนด 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 รายการ
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 ไม่พบเส้นทางระหว่างต้นทางกับจุดหมาย