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: ['*'] เนื่องจากเหตุผลต่อไปนี้
|
พร็อพเพอร์ตี้ | |
|---|---|
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 |
ประเภท:
Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint>อาร์เรย์ของปลายทาง ซึ่งกำหนดคอลัมน์ของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่ โค้ด Plus หรือชื่อทรัพยากรของสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง |
fields |
ประเภท:
Iterable<string>คอลเล็กชันของช่องที่จะดึงข้อมูล ระบุ ["*"] สำหรับทุกช่อง |
origins |
ประเภท:
Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint>อาร์เรย์ของต้นทาง ซึ่งกำหนดแถวของเมทริกซ์การตอบกลับ ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่ โค้ด Plus หรือชื่อทรัพยากรของสถานที่ ระบบจะไม่พิจารณาค่าระดับความสูง มีข้อจำกัดด้านขนาดหลายประการที่ใช้กับ Cardinality ของต้นทางและปลายทาง ดังนี้
|
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 |
ประเภท:
string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypointสถานที่ตั้งของต้นทาง ค่าที่ส่งเป็นสตริงอาจเป็นที่อยู่หรือ Plus Code ระบบจะไม่พิจารณาค่าระดับความสูง |
routeModifiers optional |
ประเภท:
RouteModifiers optionalตัวแก้ไขสำหรับทุกเส้นทางที่ใช้จุดนี้เป็นต้นทาง |