Route Matrix

คลาส RouteMatrix

ชั้นเรียน google.maps.routes.RouteMatrix

เมทริกซ์ของเส้นทางที่คำนวณสำหรับชุดคู่ต้นทาง/ปลายทางโดย RouteMatrix.computeRouteMatrix

เข้าถึงโดยโทรไปที่ const {RouteMatrix} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

วิธีการแบบคงที่

computeRouteMatrix

computeRouteMatrix(request) พารามิเตอร์  request:  ComputeRouteMatrixRequest ค่าที่แสดงผล:  Promise<{matrix:RouteMatrix}> รับรายการต้นทางและปลายทาง แล้วแสดงผลเมทริกซ์ที่มีข้อมูลเส้นทางสำหรับการรวมต้นทางและปลายทางแต่ละรายการ หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ฟิลด์การตอบกลับในคำขอโดยการตั้งค่าพร็อพเพอร์ตี้ ComputeRouteMatrixRequest.fields ค่าคือรายการเส้นทางของช่อง ตัวอย่างเช่น ฟิลด์มาสก์ของฟิลด์ที่ใช้ได้ทั้งหมด: fields: ['*'] ฟิลด์มาสก์ของระยะเวลาและระยะทางระดับเส้นทาง: fields: ['durationMillis', 'distanceMeters'] ไม่แนะนำให้ใช้ฟิลด์มาสก์การตอบกลับที่เป็นไวลด์การ์ด fields: ['*'] เนื่องจากเหตุผลต่อไปนี้ การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราประหยัดรอบการประมวลผล ซึ่งช่วยให้เราแสดงผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองต่ำลง การเลือกเฉพาะช่องที่ต้องการในงานเวอร์ชันที่ใช้งานจริงจะช่วยให้มั่นใจได้ว่าประสิทธิภาพเวลาในการตอบสนองจะเสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกช่องทั้งหมด หรือเลือกช่องทั้งหมดที่ระดับบนสุด คุณอาจพบว่าประสิทธิภาพลดลงเนื่องจากระบบจะรวมช่องใหม่ที่เราเพิ่มไว้ในการตอบกลับโดยอัตโนมัติ การเลือกเฉพาะช่องที่ต้องการจะทำให้การตอบกลับมีขนาดเล็กลง จึงโหลดผ่านเครือข่ายได้เร็วขึ้น

พร็อพเพอร์ตี้
rows	ประเภท:  Array<RouteMatrixRow> แถวของเมทริกซ์ แต่ละแถวจะสอดคล้องกับต้นทางและมีอาร์เรย์ของ RouteMatrixItem ซึ่งแต่ละรายการแสดงเส้นทางไปยังปลายทาง

เมธอด
toJSON	toJSON() พารามิเตอร์:  ไม่มี ค่าที่แสดงผล:  Object แปลงเป็นออบเจ็กต์

คลาส RouteMatrixRow

ชั้นเรียน google.maps.routes.RouteMatrixRow

สอดคล้องกับต้นทางที่ส่งไปยัง RouteMatrix.computeRouteMatrix มีรายการ RouteMatrixItem โดยแต่ละรายการแสดงเส้นทางไปยังจุดหมาย

เข้าถึงโดยโทรไปที่ const {RouteMatrixRow} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
items	ประเภท:  Array<RouteMatrixItem> ข้อมูลเส้นทางสำหรับปลายทางแต่ละแห่ง

เมธอด
toJSON	toJSON() พารามิเตอร์:  ไม่มี ค่าที่แสดงผล:  Object แปลงเป็นออบเจ็กต์

คลาส RouteMatrixItem

ชั้นเรียน google.maps.routes.RouteMatrixItem

มีข้อมูลเส้นทางที่คำนวณสำหรับคู่ต้นทาง/ปลายทางที่ส่งไปยัง RouteMatrix.computeRouteMatrix

เข้าถึงโดยโทรไปที่ const {RouteMatrixItem} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
condition	ประเภท:  RouteMatrixItemCondition optional ระบุว่าพบเส้นทางหรือไม่
distanceMeters	ประเภท:  number optional ระยะทางการเดินทางของเส้นทางเป็นเมตร
durationMillis	ประเภท:  number optional ระยะเวลาที่ต้องใช้ในการนำทางตามเส้นทางเป็นมิลลิวินาที หากคุณตั้งค่า ComputeRouteMatrixRequest.routingPreference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ RouteMatrixItem.staticDurationMillis หากคุณตั้งค่า ComputeRouteMatrixRequest.routingPreference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร หมายเหตุ: หากระยะเวลาเกิน 2^53 มิลลิวินาที ค่านี้จะเป็น Number.POSITIVE_INFINITY
error	ประเภท:  RouteMatrixItemError optional ข้อผิดพลาดที่เกิดขึ้นระหว่างการคำนวณเส้นทาง
fallbackInfo	ประเภท:  FallbackInfo optional ในบางกรณีที่เซิร์ฟเวอร์ไม่สามารถคำนวณเส้นทางด้วยค่ากำหนดที่ระบุสำหรับคู่ต้นทาง/ปลายทางนี้ ระบบอาจเปลี่ยนไปใช้โหมดการคำนวณอื่น เมื่อใช้โฆษณาสำรอง ช่องนี้จะมีข้อมูลโดยละเอียดเกี่ยวกับการตอบกลับโฆษณาสำรอง ไม่เช่นนั้น ระบบจะไม่ตั้งค่าช่องนี้
localizedValues	ประเภท:  RouteMatrixItemLocalizedValues optional การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteMatrixItem
staticDurationMillis	ประเภท:  number optional ระยะเวลาการเดินทางผ่านเส้นทางโดยไม่พิจารณาสภาพการจราจร หมายเหตุ: หากระยะเวลาเกิน 2^53 มิลลิวินาที ค่านี้จะเป็น Number.POSITIVE_INFINITY
travelAdvisory	ประเภท:  RouteTravelAdvisory optional ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง

เมธอด
toJSON	toJSON() พารามิเตอร์:  ไม่มี ค่าที่แสดงผล:  Object แปลงเป็นออบเจ็กต์

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

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

คำขอเมทริกซ์เส้นทาง

พร็อพเพอร์ตี้
destinations	ประเภท:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> อาร์เรย์ของจุดหมาย ซึ่งจะกำหนดคอลัมน์ของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่, Plus Code หรือชื่อทรัพยากรสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง
fields	ประเภท:  Iterable<string> คอลเล็กชันของช่องที่จะดึงข้อมูล ระบุ ["*"] สำหรับทุกช่อง
origins	ประเภท:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> อาร์เรย์ของจุดเริ่มต้น ซึ่งกำหนดแถวของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่, Plus Code หรือชื่อทรัพยากรสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง ข้อจำกัดด้านขนาดหลายประการมีผลกับจำนวนต้นทางและปลายทาง ดังนี้ จำนวนต้นทางและปลายทางทั้งหมดที่ระบุเป็น string หรือ Place ต้องไม่เกิน 50 รายการ ผลคูณของจำนวนต้นทางและจำนวนปลายทางต้องไม่เกิน 625 ผลคูณของจำนวนต้นทางและปลายทางต้องไม่เกิน 100 หากตั้งค่า ComputeRouteMatrixRequest.routingPreference เป็น TRAFFIC_AWARE_OPTIMAL ผลคูณของจำนวนต้นทางและปลายทางต้องไม่เกิน 100 หากตั้งค่า ComputeRouteMatrixRequest.travelMode เป็น TRANSIT
arrivalTime optional	ประเภท:  Date optional เวลาถึง หมายเหตุ: ตั้งค่าได้เมื่อตั้งค่า ComputeRouteMatrixRequest.travelMode เป็น TRANSIT เท่านั้น คุณระบุได้ทั้ง ComputeRouteMatrixRequest.departureTime หรือ ComputeRouteMatrixRequest.arrivalTime แต่จะระบุทั้ง 2 อย่างไม่ได้ การเดินทางด้วยขนส่งสาธารณะจะพร้อมใช้งานเป็นเวลาสูงสุด 7 วันในอดีตหรือ 100 วันในอนาคต
departureTime optional	ประเภท:  Date optional เวลาออกเดินทาง หากไม่ได้ตั้งค่านี้ ค่านี้จะใช้เวลาที่คุณส่งคำขอเป็นค่าเริ่มต้น หมายเหตุ: คุณจะระบุเวลาในอดีตได้ก็ต่อเมื่อตั้งค่า ComputeRouteMatrixRequest.travelMode เป็น TRANSIT เท่านั้น การเดินทางด้วยขนส่งสาธารณะจะพร้อมใช้งานเป็นเวลาสูงสุด 7 วันในอดีตหรือ 100 วันในอนาคต
extraComputations optional	ประเภท:  Iterable<ComputeRouteMatrixExtraComputation> optional รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอให้เสร็จสมบูรณ์ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ นอกจากนี้ คุณต้องระบุช่องเพิ่มเติมเหล่านี้ใน ComputeRouteMatrixRequest.fields เพื่อให้แสดงผลในการตอบกลับด้วย
language optional	ประเภท:  string optional รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษา Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากคุณไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาจากการตั้งค่าการแปลภาษาของ Google Maps JavaScript API ไม่เช่นนั้น ระบบจะอนุมานภาษาจากตำแหน่งของต้นทางแรก
region optional	ประเภท:  string optional รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ หากคุณไม่ได้ระบุค่านี้ ระบบจะอนุมานภูมิภาคจากการตั้งค่าการแปลภาษาของ Google Maps JavaScript API ไม่เช่นนั้น ระบบจะอนุมานภูมิภาคจากตำแหน่งของต้นทางแรก
routingPreference optional	ประเภท:  RoutingPreference optional ระบุวิธีคำนวณเมทริกซ์เส้นทาง เซิร์ฟเวอร์จะพยายามใช้ค่ากำหนดเส้นทางที่เลือกเพื่อคำนวณเมทริกซ์เส้นทาง หากค่ากำหนดการกำหนดเส้นทางทำให้เกิดข้อผิดพลาดหรือเวลาในการตอบสนองนานเป็นพิเศษ ระบบจะแสดงผลข้อผิดพลาด คุณจะระบุตัวเลือกนี้ได้ก็ต่อเมื่อ ComputeRouteMatrixRequest.travelMode เป็น DRIVING หรือ TWO_WHEELER เท่านั้น มิฉะนั้นคำขอจะดำเนินการไม่สำเร็จ
trafficModel optional	ประเภท:  TrafficModel optional ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการจราจร การตั้งค่านี้จะส่งผลต่อค่าที่แสดงใน RouteMatrixItem.durationMillis ซึ่งมีเวลาที่คาดการณ์ในการจราจรตามค่าเฉลี่ยที่ผ่านมา ComputeRouteMatrixRequest.trafficModel ใช้ได้กับคำขอที่ตั้งค่า ComputeRouteMatrixRequest.routingPreference เป็น TRAFFIC_AWARE_OPTIMAL และ ComputeRouteMatrixRequest.travelMode เป็น DRIVING เท่านั้น ค่าเริ่มต้นคือ BEST_GUESS
transitPreference optional	ประเภท:  TransitPreference optional ระบุค่ากำหนดที่มีผลต่อเส้นทางที่แสดงสำหรับเส้นทาง TRANSIT หมายเหตุ: ระบุได้เมื่อตั้งค่า ComputeRouteMatrixRequest.travelMode เป็น TRANSIT เท่านั้น
travelMode optional	ประเภท:  TravelMode optional ระบุรูปแบบการเดินทาง
units optional	ประเภท:  UnitSystem optional ระบุหน่วยวัดสำหรับช่องแสดงผล หากคุณไม่ระบุค่านี้ ระบบจะอนุมานหน่วยที่แสดงจากตำแหน่งของจุดเริ่มต้นแรก

ค่าคงที่ ComputeRouteMatrixExtraComputation

google.maps.routes.ComputeRouteMatrixExtraComputation ค่าคงที่

การคำนวณเพิ่มเติมที่ต้องทำสำหรับคำขอ RouteMatrix.computeRouteMatrix

เข้าถึงโดยโทรไปที่ const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
TOLLS	ข้อมูลค่าผ่านทางสำหรับรายการเมทริกซ์

ค่าคงที่ RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition ค่าคงที่

สภาพของเส้นทางสำหรับคู่ต้นทาง/ปลายทางที่ระบุ

เข้าถึงโดยโทรไปที่ const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ROUTE_EXISTS	พบเส้นทาง
ROUTE_NOT_FOUND	ไม่พบเส้นทาง

คลาส RouteMatrixItemError

ชั้นเรียน google.maps.routes.RouteMatrixItemError

ข้อผิดพลาดที่เกิดขึ้นระหว่าง RouteMatrix.computeRouteMatrix สำหรับคู่ต้นทาง/ปลายทางที่เฉพาะเจาะจง

คลาสนี้ขยาย Error

เข้าถึงโดยโทรไปที่ const {RouteMatrixItemError} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

เมธอด
toJSON	toJSON() พารามิเตอร์:  ไม่มี ค่าที่แสดงผล:  Object แปลงเป็นออบเจ็กต์

คลาส RouteMatrixItemLocalizedValues

ชั้นเรียน google.maps.routes.RouteMatrixItemLocalizedValues

การแสดงข้อความของ RouteMatrixItem

เข้าถึงโดยโทรไปที่ const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
distance	ประเภท:  string optional ระยะทางในการเดินทางของรายการเมทริกซ์เส้นทางในรูปแบบข้อความ
distanceLanguage	ประเภท:  string optional รหัสภาษา BCP-47 ของข้อความระยะทาง เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier
duration	ประเภท:  string optional ระยะเวลาที่แสดงในรูปแบบข้อความและแปลเป็นภาษาท้องถิ่นตามภูมิภาคของการค้นหา พิจารณาสภาพการจราจร หมายเหตุ: หากคุณไม่ได้ขอข้อมูลการจราจร ค่านี้จะเป็นค่าเดียวกับ RouteMatrixItemLocalizedValues.staticDuration
durationLanguage	ประเภท:  string optional รหัสภาษา BCP-47 ของข้อความระยะเวลา เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier
staticDuration	ประเภท:  string optional ระยะเวลาโดยไม่พิจารณาสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ
staticDurationLanguage	ประเภท:  string optional รหัสภาษา BCP-47 ของข้อความระยะเวลาแบบคงที่ เช่น "en-US" หรือ "sr-Latn"
transitFare	ประเภท:  string optional ค่าโดยสารขนส่งสาธารณะที่แสดงในรูปแบบข้อความ
transitFareLanguage	ประเภท:  string optional รหัสภาษา BCP-47 ของข้อความค่าโดยสารขนส่งสาธารณะ เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier

เมธอด
toJSON	toJSON() พารามิเตอร์:  ไม่มี ค่าที่แสดงผล:  Object แปลงเป็นออบเจ็กต์

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

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

ต้นทางเดียวสำหรับ ComputeRouteMatrixRequest

พร็อพเพอร์ตี้
waypoint	ประเภท:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint สถานที่ต้นทาง ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่หรือ Plus Code ระบบจะไม่พิจารณาค่าระดับความสูง
routeModifiers optional	ประเภท:  RouteModifiers optional ตัวแก้ไขสำหรับทุกเส้นทางที่ใช้จุดนี้เป็นจุดเริ่มต้น