Route Matrix (beta)

RouteMatrix class

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

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

เข้าถึงได้โดยโทรไปที่ const {RouteMatrix} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API
computeRouteMatrix
computeRouteMatrix(request)
พารามิเตอร์: 
ค่าที่ส่งคืน:  Promise<{matrix:RouteMatrix}>
รับรายการต้นทางและปลายทาง แล้วแสดงผลเมทริกซ์ที่มีข้อมูลเส้นทางสำหรับชุดค่าผสมของต้นทางและปลายทางแต่ละชุด

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ฟิลด์การตอบกลับในคำขอโดยการตั้งค่าพร็อพเพอร์ตี้ ComputeRouteMatrixRequest.fields ค่าคือรายการเส้นทางของฟิลด์

เช่น
  • ฟิลด์มาสก์ของช่องที่พร้อมใช้งานทั้งหมด: fields: ['*']
  • ฟิลด์มาสก์ของระยะเวลาและระยะทางระดับเส้นทาง: fields: ['durationMillis', 'distanceMeters']

เราไม่แนะนำให้ใช้ฟิลด์มาสก์การตอบกลับที่เป็นไวลด์การ์ด fields: ['*'] เนื่องจากเหตุผลต่อไปนี้
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราประหยัดรอบการคำนวณได้ ซึ่งจะช่วยให้เราแสดงผลลัพธ์แก่คุณโดยมีความหน่วงต่ำลง
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการในงานเวอร์ชันที่ใช้งานจริงจะช่วยให้มั่นใจได้ว่าประสิทธิภาพเวลาในการตอบสนองจะคงที่ เราอาจเพิ่มช่องคำตอบเพิ่มเติมในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกช่องทั้งหมด หรือเลือกช่องทั้งหมดที่ระดับบนสุด คุณอาจพบว่าประสิทธิภาพลดลงเนื่องจากระบบจะรวมช่องใหม่ที่เราเพิ่มลงในการตอบกลับโดยอัตโนมัติ
  • การเลือกเฉพาะฟิลด์ที่คุณต้องการจะทำให้ขนาดการตอบกลับเล็กลง และโหลดผ่านเครือข่ายได้เร็วขึ้น
rows
ประเภท:  Array<RouteMatrixRow>
แถวของเมทริกซ์ แต่ละแถวจะสอดคล้องกับต้นทางและมีอาร์เรย์ของ RouteMatrixItem แต่ละรายการแสดงเส้นทางไปยังปลายทาง
toJSON
toJSON()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Object
แปลงเป็นออบเจ็กต์

RouteMatrixRow class

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

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

เข้าถึงได้โดยโทรไปที่ const {RouteMatrixRow} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API
items
ประเภท:  Array<RouteMatrixItem>
ข้อมูลเส้นทางสำหรับแต่ละจุดหมาย
toJSON
toJSON()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Object
แปลงเป็นออบเจ็กต์

RouteMatrixItem class

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
ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง

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

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

คำขอเมทริกซ์เส้นทาง
destinations
อาร์เรย์ของปลายทาง ซึ่งกำหนดคอลัมน์ของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่ โค้ด Plus หรือชื่อทรัพยากรของสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง
fields
ประเภท:  Iterable<string>
คอลเล็กชันของช่องที่จะดึงข้อมูล ระบุ ["*"] สำหรับทุกช่อง
origins
อาร์เรย์ของต้นทาง ซึ่งกำหนดแถวของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่ โค้ด Plus หรือชื่อทรัพยากรของสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง

มีข้อจำกัดด้านขนาดหลายประการที่ใช้กับ Cardinality ของต้นทางและปลายทาง ดังนี้
  • จำนวนต้นทางและปลายทางทั้งหมดที่ระบุเป็น 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 class

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

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

ชั้นเรียนนี้ขยายเวลา Error

เข้าถึงได้โดยโทรไปที่ const {RouteMatrixItemError} = await google.maps.importLibrary("routes")
ดูไลบรารีใน Maps JavaScript API
toJSON
toJSON()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Object
แปลงเป็นออบเจ็กต์

RouteMatrixItemLocalizedValues class

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
สถานที่ตั้งของต้นทาง ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่หรือ Plus Code ระบบจะไม่พิจารณาค่าระดับความสูง
routeModifiers optional
ประเภท:  RouteModifiers optional
ตัวแก้ไขสำหรับทุกเส้นทางที่ใช้จุดนี้เป็นต้นทาง