Distance Matrix

คลาส ระยะทางMatrixService

google.maps.DistanceMatrixService คลาส

บริการสําหรับการประมวลผลระยะทางระหว่างต้นทางและปลายทางหลายแห่ง

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

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

อินเทอร์เฟซ 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
ระบบหน่วยที่ต้องการใช้เมื่อแสดงระยะทาง ไม่บังคับ กําหนดค่าเริ่มต้นเป็นเมตริก

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

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

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

อินเทอร์เฟซสําหรับ ระยะทางเมทริกซ์การตอบกลับ

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

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

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

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

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

ค่าคงที่ระยะทาง

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

ค่าคงที่ ระยะทางMatrixElementStatus

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

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

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