Distance Matrix (deprecated)

คลาส DistanceMatrixService

google.maps.DistanceMatrixService คลาส
ไลบรารี "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
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
ไม่บังคับ
ประเภท: boolean optional
หากเป็น true จะสั่งให้บริการ Distance Matrix หลีกเลี่ยงเรือข้ามฟากหากเป็นไปได้ ไม่บังคับ
avoidHighways
ไม่บังคับ
ประเภท: boolean optional
หากเป็น true จะสั่งให้บริการเมทริกซ์ระยะทางหลีกเลี่ยงทางหลวงหากเป็นไปได้ ไม่บังคับ
avoidTolls
ไม่บังคับ
ประเภท: boolean optional
หากเป็น true จะสั่งให้บริการเมทริกซ์ระยะทางหลีกเลี่ยงทางพิเศษหากเป็นไปได้ ไม่บังคับ
drivingOptions
ไม่บังคับ
ประเภท: DrivingOptions optional
การตั้งค่าที่มีผลกับคำขอที่ travelMode เป็น DRIVING เท่านั้น ออบเจ็กต์นี้จะไม่มีผลกับโหมดการเดินทางอื่นๆ
language
ไม่บังคับ
ประเภท: string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
region
ไม่บังคับ
ประเภท: string optional
รหัสภูมิภาคที่ใช้เป็นอคติสำหรับคำขอการเข้ารหัสพิกัดภูมิศาสตร์ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
transitOptions
ไม่บังคับ
ประเภท: TransitOptions optional
การตั้งค่าที่มีผลกับคำขอที่ travelMode เป็น TRANSIT เท่านั้น ออบเจ็กต์นี้จะไม่มีผลกับโหมดการเดินทางอื่นๆ
unitSystem
ไม่บังคับ
ประเภท: UnitSystem optional
ระบบหน่วยที่ต้องการใช้เมื่อแสดงระยะทาง ไม่บังคับ โดยค่าเริ่มต้นจะเป็นเมตริก

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

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

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

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

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

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

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

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

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

ค่าคงที่ DistanceMatrixStatus

google.maps.DistanceMatrixStatus ค่าคงที่
ไลบรารี "routes"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท DistanceMatrixStatusString

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

ค่าคงที่ DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus ค่าคงที่
ไลบรารี "routes"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท DistanceMatrixElementStatusString

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