Route Matrix

คลาส RouteMatrix

ชั้นเรียน google.maps.routes.RouteMatrix
ห้องสมุด "routes"

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

const {RouteMatrix} = await google.maps.importLibrary("routes");

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

computeRouteMatrix

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

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

เมธอด
รับค่ามา: toJSON

คลาส RouteMatrixRow

ชั้นเรียน google.maps.routes.RouteMatrixRow
ห้องสมุด "routes"

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes");

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

เมธอด
รับค่ามา: toJSON

คลาส RouteMatrixItem

ชั้นเรียน google.maps.routes.RouteMatrixItem
ห้องสมุด "routes"

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

const {RouteMatrixItem} = await google.maps.importLibrary("routes");

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

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

ค่าคงที่ ComputeRouteMatrixExtraComputation

constants google.maps.routes.ComputeRouteMatrixExtraComputation
library "routes"

การคำนวณเพิ่มเติมที่ต้องทำขณะดำเนินการตามคำขอให้เสร็จสมบูรณ์ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

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

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");

ค่าคงที่
TOLLS	ข้อมูลค่าผ่านทางสำหรับองค์ประกอบเมทริกซ์ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

ค่าคงที่ RouteMatrixItemCondition

constants google.maps.routes.RouteMatrixItemCondition
library "routes"

สภาพของเส้นทางที่แสดงผล ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

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

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");

ค่าคงที่
ROUTE_EXISTS	พบเส้นทางและกรอกข้อมูลที่เกี่ยวข้องสำหรับองค์ประกอบแล้ว ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ
ROUTE_NOT_FOUND	ไม่พบเส้นทาง ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

คลาส RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");

เมธอด
รับค่ามา: toJSON

คลาส RouteMatrixItemLocalizedValues

ชั้นเรียน google.maps.routes.RouteMatrixItemLocalizedValues
ห้องสมุด "routes"

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

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");

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

เมธอด
รับค่ามา: toJSON

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

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

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

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