Directions

คลาส DirectionsService

google.maps.DirectionsService ชั้นเรียน

บริการสำหรับการคำนวณเส้นทางระหว่างสถานที่ 2 แห่งขึ้นไป

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

DirectionsService
DirectionsService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ DirectionsService ที่ส่งการค้นหาเส้นทางไปยังเซิร์ฟเวอร์ของ Google
route
route(request[, callback])
พารามิเตอร์: 
ค่าที่ส่งคืน:  Promise<DirectionsResult>
ส่งคำขอค้นหาเส้นทาง

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

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

ข้อความค้นหาเส้นทางที่จะส่งไปที่ DirectionsService

destination
ประเภท:  string|LatLng|Place|LatLngLiteral
ตำแหน่งของจุดหมาย สามารถระบุเป็นสตริงที่จะถูกระบุพิกัดทางภูมิศาสตร์ หรือ LatLng หรือ Place ต้องระบุ
origin
ประเภท:  string|LatLng|Place|LatLngLiteral
ตำแหน่งต้นทาง สามารถระบุเป็นสตริงที่จะถูกระบุพิกัดทางภูมิศาสตร์ หรือ LatLng หรือ Place ต้องระบุ
travelMode
ประเภท:  TravelMode
ประเภทการกำหนดเส้นทางที่ขอ ต้องระบุ
avoidFerries optional
ประเภท:  boolean optional
หากเป็น true แจ้งบริการเส้นทางให้หลีกเลี่ยงเรือข้ามฟาก หากทำได้ ไม่บังคับ
avoidHighways optional
ประเภท:  boolean optional
หากเป็น true สั่งให้บริการเส้นทางหลีกเลี่ยงทางหลวงหากเป็นไปได้ ไม่บังคับ
avoidTolls optional
ประเภท:  boolean optional
หากเป็น true สั่งให้บริการเส้นทางหลีกเลี่ยงถนนที่เรียกเก็บค่าผ่านทางหากเป็นไปได้ ไม่บังคับ
drivingOptions optional
ประเภท:  DrivingOptions optional
การตั้งค่าที่มีผลเฉพาะกับคำขอที่ travelMode เป็น DRIVING ออบเจ็กต์นี้จะไม่ส่งผลต่อโหมดการเดินทางอื่นๆ
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ เมื่อเป็นไปได้ ดูรายการภาษาที่รองรับ
optimizeWaypoints optional
ประเภท:  boolean optional
หากตั้งค่าเป็น true DirectionsService จะพยายามเรียงลำดับจุดอ้างอิงระดับกลางที่ให้ไว้ใหม่เพื่อลดค่าใช้จ่ายโดยรวมของเส้นทาง หากมีการเพิ่มประสิทธิภาพจุดอ้างอิง ให้ตรวจสอบ DirectionsRoute.waypoint_order ในการตอบสนองเพื่อกำหนดลำดับใหม่
provideRouteAlternatives optional
ประเภท:  boolean optional
ระบุเส้นทางทางเลือกหรือไม่ ไม่บังคับ
region optional
ประเภท:  string optional
รหัสภูมิภาคที่ใช้เป็นการให้น้ำหนักพิเศษสำหรับคำขอการเข้ารหัสพิกัดภูมิศาสตร์ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 แต่มีข้อยกเว้นบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (ทางเทคนิคสำหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
transitOptions optional
ประเภท:  TransitOptions optional
การตั้งค่าที่มีผลเฉพาะกับคำขอที่ travelMode คือ TRANSIT ออบเจ็กต์นี้จะไม่ส่งผลต่อโหมดการเดินทางอื่นๆ
unitSystem optional
ประเภท:  UnitSystem optional
ค่าเริ่มต้น: ระบบของหน่วยที่ใช้ในประเทศต้นทาง
ระบบหน่วยที่ต้องการเมื่อแสดงระยะทาง
waypoints optional
ประเภท:  Array<DirectionsWaypoint> optional
อาร์เรย์ของจุดอ้างอิงระดับกลาง ระบบจะคำนวณเส้นทางจากต้นทางถึงปลายทางโดยใช้จุดอ้างอิงแต่ละจุดในอาร์เรย์นี้ โปรดดู คู่มือนักพัฒนาซอฟต์แวร์เพื่อดูจำนวนจุดอ้างอิงสูงสุดที่อนุญาต เส้นทางขนส่งสาธารณะไม่รองรับจุดอ้างอิง ไม่บังคับ

ค่าคงที่ DirectionsStatus

ค่าคงที่ google.maps.DirectionsStatus

สถานะที่ DirectionsService ส่งคืนเมื่อโทรหา route() จนเสร็จสมบูรณ์ ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'OK' หรือ google.maps.DirectionsStatus.OK

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

INVALID_REQUEST DirectionsRequest ที่ระบุไม่ถูกต้อง
MAX_WAYPOINTS_EXCEEDED ระบุ DirectionsWaypoint ใน DirectionsRequest มากเกินไป โปรดดู คู่มือนักพัฒนาซอฟต์แวร์เพื่อดูจำนวนจุดอ้างอิงสูงสุดที่อนุญาต
NOT_FOUND ระบบระบุพิกัดภูมิศาสตร์ของต้นทาง ปลายทาง หรือจุดอ้างอิงอย่างน้อย 1 รายการไม่ได้
OK การตอบกลับมี DirectionsResult ที่ถูกต้อง
OVER_QUERY_LIMIT หน้าเว็บมีคำขอเกินขีดจำกัดในระยะเวลาอันสั้นเกินไป
REQUEST_DENIED หน้าเว็บไม่ได้รับอนุญาตให้ใช้บริการเส้นทาง
UNKNOWN_ERROR ดำเนินการตามคำขอเส้นทางไม่ได้เนื่องจากเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง
ZERO_RESULTS ไม่พบเส้นทางระหว่างต้นทางและปลายทาง

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

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

การตอบกลับเส้นทางที่ดึงจากเซิร์ฟเวอร์เส้นทาง คุณสามารถแสดงผลรายการเหล่านี้โดยใช้ DirectionsRenderer หรือแยกวิเคราะห์ออบเจ็กต์นี้และแสดงผลด้วยตัวเอง คุณต้องแสดงคำเตือนและลิขสิทธิ์ตามที่ระบุไว้ในข้อกำหนดในการให้บริการของ Google Maps Platform โปรดทราบว่าแม้ผลลัพธ์นี้จะเป็น "เหมือน JSON" แต่ก็ไม่ใช่ JSON อย่างเคร่งครัด เนื่องจากมีออบเจ็กต์ LatLng รายการโดยอ้อม

request
ประเภท:  DirectionsRequest
DirectionsRequest ที่ได้ผลลัพธ์นี้
routes
ประเภท:  Array<DirectionsRoute>
อาร์เรย์ของ DirectionsRoute ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับขาและขั้นตอนที่ประกอบขึ้น มีเพียงเส้นทางเดียวเท่านั้น เว้นแต่ DirectionsRequest จะสร้างด้วย provideRouteAlternatives เป็น true
available_travel_modes optional
ประเภท:  Array<TravelMode> optional
มีรูปแบบการเดินทางที่หลากหลาย ระบบจะแสดงช่องนี้เมื่อคำขอระบุรูปแบบการเดินทางและไม่ได้รับผลลัพธ์ อาร์เรย์ประกอบด้วยรูปแบบการเดินทางที่ใช้ได้ในประเทศของจุดอ้างอิงที่กำหนด หากจุดอ้างอิงอย่างน้อย 1 จุดเป็น "ผ่านจุดอ้างอิง" ระบบจะไม่แสดงผลช่องนี้
geocoded_waypoints optional
ประเภท:  Array<DirectionsGeocodedWaypoint> optional
อาร์เรย์ของ DirectionsGeocodedWaypoint ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์ของต้นทาง ปลายทาง และจุดอ้างอิง

คลาส DirectionsRenderer

google.maps.DirectionsRenderer ชั้นเรียน

แสดงผลเส้นทางที่ได้รับจาก DirectionsService

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

DirectionsRenderer
DirectionsRenderer([opts])
พารามิเตอร์: 
สร้างโหมดแสดงภาพด้วยตัวเลือกที่ระบุ สามารถแสดงเส้นทางบนแผนที่ (เป็นการวางซ้อนภาพ) หรือเพิ่มเติมจากแผง <div> (เป็นวิธีการแบบข้อความ)
getDirections
getDirections()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  DirectionsResult
แสดงผลชุดเส้นทางปัจจุบันของโหมดแสดงภาพ
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map
แสดงผลแผนที่ที่แสดง DirectionsResult
getPanel
getPanel()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  HTMLElement|null
แสดงผลแผง <div> ที่มีการแสดงผล DirectionsResult
getRouteIndex
getRouteIndex()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  number
แสดงดัชนีเส้นทางปัจจุบัน (แบบศูนย์) ที่ออบเจ็กต์ DirectionsRenderer นี้ใช้งานอยู่
setDirections
setDirections(directions)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ตั้งค่าโหมดแสดงภาพเพื่อใช้ผลลัพธ์จาก DirectionsService การกำหนดชุดเส้นทางที่ถูกต้องในลักษณะนี้จะแสดงเส้นทางบนแผนที่และแผงที่กำหนดของโหมดแสดงภาพ
setMap
setMap(map)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
เมธอดนี้จะระบุแผนที่ที่เส้นทางจะแสดงผล ผ่าน null เพื่อนำเส้นทางออกจากแผนที่
setOptions
setOptions(options)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
เปลี่ยนการตั้งค่าตัวเลือกของ DirectionsRenderer นี้หลังจากการเริ่มต้น
setPanel
setPanel(panel)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
วิธีนี้จะแสดงผลเส้นทางใน <div> ส่ง null เพื่อนำเนื้อหาออกจากแผง
setRouteIndex
setRouteIndex(routeIndex)
พารามิเตอร์: 
  • routeIndexnumber
ผลลัพธ์: ไม่มี
ตั้งค่าดัชนี (แบบฐานศูนย์) ของเส้นทางในออบเจ็กต์ DirectionsResult เพื่อแสดงผล โดยค่าเริ่มต้น ระบบจะแสดงผลเส้นทางแรกในอาร์เรย์
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อเส้นทางที่แสดงผลเปลี่ยนไป ไม่ว่าจะเป็นการตั้งค่า DirectionsResult ใหม่ หรือเมื่อผู้ใช้ลากเส้นทางเพื่อเปลี่ยนเส้นทางจนเสร็จ

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

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

ออบเจ็กต์นี้กำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ในออบเจ็กต์ DirectionsRenderer

directions optional
ประเภท:  DirectionsResult optional
เส้นทางที่จะแสดงบนแผนที่และ/หรือในแผง <div> ที่ดึงข้อมูลเป็นวัตถุ DirectionsResult จาก DirectionsService
draggable optional
ประเภท:  boolean optional
หากเป็น true จะอนุญาตให้ผู้ใช้ลากและแก้ไขเส้นทางของเส้นทางที่แสดงผลโดย DirectionsRenderer นี้ได้
hideRouteList optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
คุณสมบัตินี้จะระบุว่าโหมดแสดงภาพควรแสดงรายการเส้นทางที่ผู้ใช้เลือกได้ซึ่งแสดงในแผงเส้นทางหรือไม่
infoWindow optional
ประเภท:  InfoWindow optional
InfoWindow ที่จะแสดงข้อมูลข้อความเมื่อมีการคลิกเครื่องหมาย เนื้อหาหน้าต่างข้อมูลที่มีอยู่จะถูกเขียนทับและย้ายตำแหน่ง หากไม่ได้ระบุหน้าต่างข้อมูล DirectionsRenderer จะสร้างและใช้หน้าต่างข้อมูลของตัวเอง ระบบจะไม่สนใจพร็อพเพอร์ตี้นี้หากตั้งค่า suppressInfoWindows เป็น true
map optional
ประเภท:  Map optional
แผนที่ที่จะแสดงเส้นทาง
markerOptions optional
ประเภท:  MarkerOptions optional
ตัวเลือกสำหรับเครื่องหมาย ตัวทำเครื่องหมายทั้งหมดที่แสดงผลโดย DirectionsRenderer จะใช้ตัวเลือกเหล่านี้
panel optional
ประเภท:  HTMLElement optional
<div> ซึ่งแสดงขั้นตอนของเส้นทาง
polylineOptions optional
ประเภท:  PolylineOptions optional
ตัวเลือกสำหรับเส้นประกอบ โพลีไลน์ทั้งหมดที่แสดงผลโดย DirectionsRenderer จะใช้ตัวเลือกเหล่านี้
preserveViewport optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
หากใช้ตัวเลือกนี้เป็น true หรือไม่ได้ตั้งศูนย์กลางและการซูมของแผนที่ไว้ แผนที่ป้อนข้อมูลจะตั้งศูนย์กลางและซูมไปที่กรอบล้อมรอบของเส้นทางชุดนี้
routeIndex optional
ประเภท:  number optional
ดัชนีของเส้นทางภายในออบเจ็กต์ DirectionsResult ค่าเริ่มต้นคือ 0
suppressBicyclingLayer optional
ประเภท:  boolean optional
ระงับการแสดงภาพ BicyclingLayer เมื่อมีการขอเส้นทางจักรยาน
suppressInfoWindows optional
ประเภท:  boolean optional
ระงับการแสดงผลหน้าต่างข้อมูล
suppressMarkers optional
ประเภท:  boolean optional
ระงับการแสดงผลตัวทำเครื่องหมาย
suppressPolylines optional
ประเภท:  boolean optional
ระงับการแสดงผลของเส้นประกอบ

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

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

DirectionsWaypoint แสดงถึงตำแหน่งระหว่างต้นทางและจุดหมายที่ใช้กำหนดเส้นทางการเดินทาง

location optional
ประเภท:  string|LatLng|LatLngLiteral|Place optional
ตำแหน่งจุดอ้างอิง อาจเป็นสตริงที่อยู่, LatLng หรือ Place ไม่บังคับ
stopover optional
ประเภท:  boolean optional
ค่าเริ่มต้น: true
หากเป็น true แสดงว่าจุดอ้างอิงนี้เป็นจุดแวะระหว่างต้นทางและปลายทาง การแยกเส้นทางออกเป็น 2 ขา หากเป็น false แสดงว่าเส้นทางนี้ควรมีการให้น้ำหนักพิเศษเพื่อผ่านจุดอ้างอิงนี้ แต่ไม่แยกเป็น 2 ขา วิธีนี้มีประโยชน์ถ้าคุณต้องการสร้างเส้นทางเพื่อตอบสนองเมื่อผู้ใช้ลากจุดอ้างอิงบนแผนที่

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

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

จุดอ้างอิงที่เข้ารหัสพิกัดภูมิศาสตร์จุดเดียว

partial_match optional
ประเภท:  boolean optional
ดูว่าโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ไม่แสดงการจับคู่ที่ตรงกันทุกประการกับจุดอ้างอิงเดิม แม้ว่าจะสามารถจับคู่บางส่วนของที่อยู่ที่ขอได้
place_id optional
ประเภท:  string optional
รหัสสถานที่ที่เชื่อมโยงกับการชี้ทาง รหัสสถานที่จะระบุสถานที่อย่างไม่ซ้ำกันในฐานข้อมูลของ Google Places และบน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API
types optional
ประเภท:  Array<string> optional
อาร์เรย์ของสตริงที่แสดงถึงประเภทขององค์ประกอบที่เข้ารหัสพิกัดภูมิศาสตร์ที่แสดงผล สำหรับรายการสตริงที่เป็นไปได้ โปรดดูที่ส่วน ประเภทคอมโพเนนต์ที่อยู่ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์

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

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

เส้นทางเดียวที่มีชุดขาใน DirectionsResult โปรดทราบว่าแม้ออบเจ็กต์นี้จะ "เหมือน JSON" แต่ก็ไม่ใช่ JSON อย่างเคร่งครัด เนื่องจากมีออบเจ็กต์ LatLng ทั้งโดยตรงและโดยอ้อม

bounds
ประเภท:  LatLngBounds
ขอบเขตของเส้นทางนี้
copyrights
ประเภท:  string
ข้อความลิขสิทธิ์ที่จะแสดงสำหรับเส้นทางนี้
legs
ประเภท:  Array<DirectionsLeg>
อาร์เรย์ของ DirectionsLeg ซึ่งแต่ละอาร์เรย์จะมีข้อมูลเกี่ยวกับขั้นตอนในการสร้างอาร์เรย์ แต่ละจุดแวะพักหรือจุดหมายที่ระบุไว้จะมี 1 ขา ดังนั้นเส้นทางที่ไม่มีจุดแวะระหว่างทางจะมี DirectionsLeg 1 จุด ส่วนเส้นทางที่มีจุดแวะพัก 1 จุดจะมี 2 จุด
overview_path
ประเภท:  Array<LatLng>
อาร์เรย์ของ LatLng ที่แสดงถึงเส้นทางตลอดเส้นทางนี้ ระบบจะลดความซับซ้อนของเส้นทางเพื่อให้เหมาะกับบริบทที่ต้องมีจุดยอดเพียงไม่กี่จุด (เช่น URL ของ Maps API แบบคงที่)
overview_polyline
ประเภท:  string
การแสดงเส้นประกอบที่เข้ารหัสของเส้นทางในoverview_path เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (เรียบ) ของเส้นทางที่ได้รับ
summary
ประเภท:  string
ประกอบด้วยคำอธิบายเส้นทางแบบข้อความสั้นๆ เหมาะสำหรับการตั้งชื่อและอธิบายเส้นทางจากทางเลือกอื่น
warnings
ประเภท:  Array<string>
คำเตือนที่จะแสดงเมื่อแสดงคำแนะนำเหล่านี้
waypoint_order
ประเภท:  Array<number>
หากตั้งค่า optimizeWaypoints เป็น true ช่องนี้จะมีการเรียงสับเปลี่ยนจุดอ้างอิงอินพุตที่เรียงลำดับใหม่ เช่น หากอินพุตคือ
ต้นทาง: ลอสแอนเจลิส
Waypoints: Dallas, Bangor, Phoenix
Destination: New York
และผลลัพธ์ที่เพิ่มประสิทธิภาพมีการจัดเรียงดังนี้
ต้นทาง: ลอสแอนเจลิส
Waypoints: Phoenix, Dallas, Bangor
Destination: New York
ช่องนี้จะเป็น Array ที่มีค่าเป็น [2, 0] โปรดทราบว่าจำนวนจุดอ้างอิงจะยึดตาม 0
หากจุดอ้างอิงอินพุตใดก็ตามมีการตั้งค่า stopover เป็น false ช่องนี้จะว่างเปล่า เนื่องจากการเพิ่มประสิทธิภาพเส้นทางไม่พร้อมใช้งานสำหรับการค้นหาดังกล่าว
fare optional
ประเภท:  TransitFare optional
ค่าโดยสารรวมสำหรับการเดินทางด้วยขนส่งสาธารณะ ใช้ได้กับคำขอขนส่งสาธารณะเท่านั้น

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

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

ขาเดียวที่ประกอบด้วยชุดขั้นตอนใน DirectionsResult บางช่องอาจแสดงผลไม่ได้สำหรับคำขอทั้งหมด โปรดทราบว่าแม้ผลลัพธ์นี้จะเป็น "เหมือน JSON" แต่ก็ไม่ใช่ JSON อย่างเคร่งครัด เนื่องจากมีออบเจ็กต์ LatLng รายการโดยตรงและโดยอ้อม

end_address
ประเภท:  string
ที่อยู่ของปลายทางของขานี้ เนื้อหานี้ให้อ่านตามที่เป็นอยู่ โปรดอย่าแยกวิเคราะห์ที่อยู่ที่มีการจัดรูปแบบโดยใช้โปรแกรม
end_location
ประเภท:  LatLng
DirectionsService จะคำนวณเส้นทางระหว่างสถานที่ต่างๆ โดยใช้ตัวเลือกการขนส่งที่ใกล้ที่สุด (โดยปกติจะเป็นถนน) ที่จุดเริ่มต้นและจุดสิ้นสุด end_location ระบุปลายทางจริงที่เข้ารหัสพิกัดภูมิศาสตร์ ซึ่งอาจต่างจาก end_location ของขั้นตอนสุดท้าย หากถนนไม่ได้อยู่ใกล้กับปลายทางของขานี้
start_address
ประเภท:  string
ที่อยู่ของต้นทางของขานี้ เนื้อหานี้ให้อ่านตามที่เป็นอยู่ โปรดอย่าแยกวิเคราะห์ที่อยู่ที่มีการจัดรูปแบบโดยใช้โปรแกรม
start_location
ประเภท:  LatLng
DirectionsService จะคำนวณเส้นทางระหว่างสถานที่ต่างๆ โดยใช้ตัวเลือกการขนส่งที่ใกล้ที่สุด (โดยปกติจะเป็นถนน) ที่จุดเริ่มต้นและจุดสิ้นสุด start_location บ่งชี้ต้นทางที่ระบุพิกัดภูมิศาสตร์จริง ซึ่งอาจแตกต่างจาก start_location ของขั้นตอนแรก เช่น ถนนไม่ได้อยู่ใกล้กับต้นทางของขานี้
steps
ประเภท:  Array<DirectionsStep>
อาร์เรย์ของ DirectionsStep ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับแต่ละขั้นตอนในขานี้
traffic_speed_entry
ประเภท:  Array<?>
ข้อมูลเกี่ยวกับความเร็วการจราจรตามเส้นทาง
via_waypoints
ประเภท:  Array<LatLng>
อาร์เรย์ของจุดอ้างอิงที่ไม่หยุดนิ่งตลอดเส้นทางนี้ ซึ่งระบุในคำขอเดิม

เลิกใช้งานในเส้นทางอื่น เวอร์ชัน 3.27 จะเป็น API เวอร์ชันสุดท้ายที่เพิ่ม via_waypoints ในเส้นทางอื่นๆ

เมื่อใช้บริการเส้นทางเพื่อใช้เส้นทางที่สามารถลากได้ ขอแนะนำให้ปิดใช้การลากเส้นทางอื่น ควรลากได้เฉพาะเส้นทางหลักเท่านั้น ผู้ใช้สามารถลากเส้นทางหลักจนกว่าจะตรงกับเส้นทางอื่น

arrival_time optional
ประเภท:  Time optional
เวลาถึงโดยประมาณสำหรับขานี้ ใช้ได้กับคำขอ TRANSIT เท่านั้น
departure_time optional
ประเภท:  Time optional
เวลาออกเดินทางโดยประมาณของขานี้ ใช้ได้กับคำขอ TRANSIT เท่านั้น
distance optional
ประเภท:  Distance optional
ระยะทางรวมที่ขานี้ครอบคลุม พร็อพเพอร์ตี้นี้ไม่สามารถกําหนดได้เนื่องจากอาจไม่ทราบระยะทาง
duration optional
ประเภท:  Duration optional
ระยะเวลารวมของขานี้ พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากไม่ทราบระยะเวลา
duration_in_traffic optional
ประเภท:  Duration optional
ระยะเวลารวมของช่วงนี้เมื่อพิจารณาสภาพการจราจรที่ระบุโดยพร็อพเพอร์ตี้ trafficModel พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากไม่ทราบระยะเวลา

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

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

DirectionsStep รายการเดียวใน DirectionsResult บางช่องอาจเป็น undefined โปรดทราบว่าแม้ออบเจ็กต์นี้จะ "เหมือน JSON" แต่ก็ไม่ใช่ JSON อย่างเคร่งครัด เนื่องจากมีออบเจ็กต์ LatLng โดยตรง

encoded_lat_lngs
ประเภท:  string
การแสดงเส้นประกอบที่เข้ารหัสของขั้นตอน นี่คือเส้นทางโดยประมาณ (เรียบ) ของขั้นตอน
end_location
ประเภท:  LatLng
ตำแหน่งสิ้นสุดของขั้นตอนนี้
end_point
ประเภท:  LatLng
ตำแหน่งสิ้นสุดของขั้นตอนนี้
instructions
ประเภท:  string
วิธีการสำหรับขั้นตอนนี้
lat_lngs
ประเภท:  Array<LatLng>
ลำดับของ LatLng ที่อธิบายขั้นนี้ นี่คือเส้นทางโดยประมาณ (เรียบ) ของขั้นตอน
maneuver
ประเภท:  string
มีการดำเนินการที่จะทำในขั้นตอนปัจจุบัน (turn-left, merge, straight ฯลฯ) ค่าอาจมีการเปลี่ยนแปลง และอาจแนะนําค่าใหม่โดยไม่ต้องแจ้งให้ทราบล่วงหน้า
path
ประเภท:  Array<LatLng>
ลำดับของ LatLng ที่อธิบายขั้นนี้ นี่คือเส้นทางโดยประมาณ (เรียบ) ของขั้นตอน
start_location
ประเภท:  LatLng
ตำแหน่งเริ่มต้นของขั้นตอนนี้
start_point
ประเภท:  LatLng
ตำแหน่งเริ่มต้นของขั้นตอนนี้
travel_mode
ประเภท:  TravelMode
รูปแบบการเดินทางที่ใช้ในขั้นตอนนี้
distance optional
ประเภท:  Distance optional
ระยะทางที่ครอบคลุมโดยขั้นตอนนี้ พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากไม่ทราบระยะทาง
duration optional
ประเภท:  Duration optional
เวลาปกติที่ต้องใช้ในการทำขั้นตอนนี้ในหน่วยวินาทีในรูปแบบข้อความ พร็อพเพอร์ตี้นี้อาจเป็น undefined เนื่องจากไม่ทราบระยะเวลา
polyline optional
ประเภท:  DirectionsPolyline optional
มีวัตถุที่มีพร็อพเพอร์ตี้เดียว "พอยท์" ซึ่งแสดงเส้นประกอบที่เข้ารหัสของขั้นตอน เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (เรียบ) ของขั้นตอน
steps optional
ประเภท:  Array<DirectionsStep> optional
ขั้นตอนย่อยของขั้นตอนนี้ ระบุไว้สำหรับส่วนที่ไม่ใช่ขนส่งสาธารณะของเส้นทางขนส่งสาธารณะ
transit optional
ประเภท:  TransitDetails optional
รายละเอียดเฉพาะสำหรับขนส่งสาธารณะเกี่ยวกับขั้นตอนนี้ จะไม่มีการกำหนดพร็อพเพอร์ตี้นี้ เว้นแต่ว่าวิธีการเดินทางของขั้นตอนนี้คือ TRANSIT
transit_details optional
ประเภท:  TransitDetails optional
รายละเอียดเกี่ยวกับขั้นตอนนี้หากรูปแบบการเดินทางคือ TRANSIT

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

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

วัตถุที่มีพร็อพเพอร์ตี้ points เพื่ออธิบายเส้นประกอบของ DirectionsStep

points
ประเภท:  string

อินเทอร์เฟซสถานที่

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

มีข้อมูลที่จำเป็นในการค้นหา ระบุ หรืออธิบายสถานที่สำหรับ DirectionsRequest หรือ DistanceMatrixRequest ในบริบทนี้ "สถานที่" หมายถึงธุรกิจ จุดสนใจ หรือสถานที่ตั้งทางภูมิศาสตร์ สำหรับการดึงข้อมูลเกี่ยวกับสถานที่ โปรดดู PlacesService

location optional
ประเภท:  LatLng|LatLngLiteral optional
LatLng ของรายการที่สถานที่นี้อธิบายไว้
placeId optional
ประเภท:  string optional
รหัสสถานที่ของสถานที่ (เช่น ธุรกิจหรือจุดสนใจ) รหัสสถานที่คือตัวระบุที่ไม่ซ้ำของสถานที่ในฐานข้อมูลของ Google Maps โปรดทราบว่า placeId เป็นวิธีที่แม่นยำที่สุดในการระบุสถานที่ หากเป็นไปได้ คุณควรระบุ placeId แทน query รหัสสถานที่สามารถดึงมาจากคำขอใดก็ได้ที่ส่งไปยัง Places API เช่น TextSearch รหัสสถานที่ยังสามารถดึงข้อมูลจากคำขอไปยัง Geocoding API ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของรหัสสถานที่
query optional
ประเภท:  string optional
คำค้นหาที่อธิบายสถานที่ (เช่น ธุรกิจหรือจุดสนใจ) ตัวอย่างการค้นหาคือ "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW" หากเป็นไปได้ คุณควรระบุ placeId แทน query API ไม่รับประกันความถูกต้องของการค้นหาสตริงคำค้นหาในสถานที่ หากมีการระบุทั้ง placeId และ query ระบบจะแสดงข้อผิดพลาด

ค่าคงที่ TravelMode

ค่าคงที่ google.maps.TravelMode

รูปแบบการเดินทางที่ถูกต้องซึ่งสามารถระบุใน DirectionsRequest รวมถึงรูปแบบการเดินทางที่แสดงผลใน DirectionsStep ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'BICYCLING' หรือ google.maps.TravelMode.BICYCLING

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

BICYCLING ระบุคำขอเส้นทางจักรยาน
DRIVING ระบุคำขอเส้นทางการขับขี่
TRANSIT ระบุคำขอเส้นทางขนส่งสาธารณะ
WALKING ระบุคำขอเส้นทางเดินเท้า

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

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

กำหนดค่า DirectionsRequest เมื่อตั้งค่ารูปแบบการเดินทางเป็น DRIVING

departureTime
ประเภท:  Date
เวลาออกเดินทางที่ต้องการสำหรับเส้นทาง ระบุเป็นออบเจ็กต์ Date ออบเจ็กต์ Date วัดเวลาเป็นมิลลิวินาทีตั้งแต่วันที่ 1 มกราคม 1970 ต้องระบุเพื่อให้ DrivingOptions ใช้งานได้ เวลาออกเดินทางต้องเป็นเวลาปัจจุบันหรือเวลาในอนาคต ไม่สามารถเป็นวันที่ผ่านมาแล้ว
trafficModel optional
ประเภท:  TrafficModel optional
สมมติฐานที่แนะนำให้ใช้เมื่อคาดการณ์ระยะเวลาในการเข้าชม โดยมีค่าเริ่มต้นเป็น BEST_GUESS

ค่าคงที่ TrafficModel

ค่าคงที่ google.maps.TrafficModel

สมมติฐานที่จะใช้เมื่อคาดการณ์ระยะเวลาในการเข้าชม ระบุเป็นส่วนหนึ่งของ DirectionsRequest หรือ DistanceMatrixRequest ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'bestguess' หรือ google.maps.TrafficModel.BEST_GUESS

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

BEST_GUESS ใช้ข้อมูลการเข้าชมที่ผ่านมาเพื่อประมาณเวลาที่ใช้ในการเข้าชมได้ดีที่สุด
OPTIMISTIC ใช้ข้อมูลการเข้าชมที่ผ่านมาเพื่อให้ประมาณการระยะเวลาการเข้าชมได้อย่างมีประสิทธิภาพ
PESSIMISTIC ใช้ข้อมูลการเข้าชมที่ผ่านมาในการประเมินระยะเวลาการเข้าชมในลักษณะใกล้เคียงที่สุด

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

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

ออบเจ็กต์ TransitOptions รวมอยู่ใน DirectionsRequest เมื่อตั้งค่าโหมดการเดินทางเป็น TRANSIT

arrivalTime optional
ประเภท:  Date optional
เวลาถึงที่ต้องการสำหรับเส้นทาง ระบุเป็นออบเจ็กต์วันที่ ออบเจ็กต์วันที่วัดเวลาเป็นมิลลิวินาทีตั้งแต่วันที่ 1 มกราคม 1970 หากระบุเวลาถึงไว้ ระบบจะไม่สนใจเวลาออกเดินทาง
departureTime optional
ประเภท:  Date optional
เวลาออกเดินทางที่ต้องการสำหรับเส้นทาง ระบุเป็นออบเจ็กต์วันที่ ออบเจ็กต์วันที่วัดเวลาเป็นมิลลิวินาทีตั้งแต่วันที่ 1 มกราคม 1970 หากไม่ได้ระบุเวลาออกเดินทางและเวลาถึง ระบบจะถือว่าเวลาเป็น "ตอนนี้"
modes optional
ประเภท:  Array<TransitMode> optional
รูปแบบการเดินทางที่ต้องการอย่างน้อย 1 รูปแบบ เช่น รถประจำทางหรือรถไฟ หากไม่มีค่ากำหนด API จะแสดงเส้นทางที่ดีที่สุดเริ่มต้น
routingPreference optional
ประเภท:  TransitRoutePreference optional
ค่ากำหนดที่อาจทำให้เกิดความเอนเอียงต่อตัวเลือกเส้นทางขนส่งสาธารณะ เช่น เส้นทางที่เดินน้อยกว่า หากไม่มีค่ากำหนด API จะแสดงเส้นทางที่ดีที่สุดเริ่มต้น

ค่าคงที่ TransitMode

ค่าคงที่ google.maps.TransitMode

รูปแบบการเดินทางที่ถูกต้อง เช่น รถประจำทางที่ระบุได้ใน TransitOptions ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'BUS' หรือ google.maps.TransitMode.BUS

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

BUS ระบุรถประจำทางเป็นรูปแบบการเดินทางที่ต้องการ
RAIL ระบุให้รถไฟเป็นวิธีการเดินทางที่ต้องการ
SUBWAY ระบุให้รถไฟใต้ดินเป็นรูปแบบการเดินทางที่ต้องการ
TRAIN ระบุให้รถไฟเป็นวิธีการเดินทางที่ต้องการ
TRAM ระบุรถรางเป็นวิธีการเดินทางที่ต้องการ

ค่าคงที่ TransitRoutePreference

ค่าคงที่ google.maps.TransitRoutePreference

ประเภทเส้นทางขนส่งสาธารณะที่ถูกต้องซึ่งสามารถระบุใน TransitOptions ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'LESS_WALKING' หรือ google.maps.TransitRoutePreference.LESS_WALKING

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

FEWER_TRANSFERS ระบุว่าเส้นทางที่คำนวณควรต่อจำนวนการโอนที่จำกัด
LESS_WALKING ระบุว่าเส้นทางที่คำนวณควรเดินจำนวนจำกัด

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

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

ค่าโดยสารของ DirectionsRoute ประกอบด้วยมูลค่าและสกุลเงิน

currency
ประเภท:  string
รหัสสกุลเงิน ISO 4217 ที่ระบุสกุลเงินที่แสดงค่าโดยสาร
value
ประเภท:  number
ค่าที่เป็นตัวเลขของค่าโดยสารที่แสดงใน currency ที่ระบุ

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

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

รายละเอียดเกี่ยวกับการออกเดินทาง ขาเข้า และโหมดของการขนส่งที่ใช้ในขั้นตอนนี้

arrival_stop
ประเภท:  TransitStop
ป้ายหยุดขาเข้าของขั้นตอนขนส่งสาธารณะนี้
arrival_time
ประเภท:  Time
เวลาถึงของขั้นตอนนี้ ระบุเป็นออบเจ็กต์เวลา
departure_stop
ประเภท:  TransitStop
จุดเริ่มต้นของขั้นตอนขนส่งสาธารณะนี้
departure_time
ประเภท:  Time
เวลาออกเดินทางของขั้นตอนนี้ ระบุเป็นออบเจ็กต์เวลา
headsign
ประเภท:  string
เส้นทางที่จะเดินทางในสายนี้ ตามที่มีการทำเครื่องหมายไว้บนยานพาหนะหรือที่ป้ายจอดรถขาออก
headway
ประเภท:  number
จำนวนวินาทีที่คาดไว้ระหว่างยานพาหนะที่เทียบเท่าที่จุดแวะพักนี้
line
ประเภท:  TransitLine
รายละเอียดเกี่ยวกับเส้นทางขนส่งสาธารณะที่ใช้ในขั้นตอนนี้
num_stops
ประเภท:  number
จำนวนครั้งที่แวะพักในขั้นตอนนี้ รวมป้ายหยุดขาเข้า แต่ไม่ใช่ป้ายต้นทาง
trip_short_name
ประเภท:  string
ข้อความที่ปรากฏในตารางเวลาและป้ายป้ายที่จะระบุการเดินทางด้วยขนส่งสาธารณะให้แก่ผู้โดยสาร เช่น เพื่อระบุหมายเลขรถไฟสำหรับการเดินทางโดยรถไฟ ข้อความจะระบุการเดินทางที่ไม่ซ้ำกันภายใน 1 วันให้บริการ

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

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

รายละเอียดเกี่ยวกับป้ายจอดรถหรือสถานี

location
ประเภท:  LatLng
ตำแหน่งของป้ายจอดรถนี้
name
ประเภท:  string
ชื่อของป้ายจอดรถแห่งนี้

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

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

ข้อมูลเกี่ยวกับเส้นทางขนส่งสาธารณะที่ดำเนินการในขั้นตอนขนส่งสาธารณะนี้

agencies
ประเภท:  Array<TransitAgency>
บริษัทขนส่งที่ดําเนินการเส้นทางขนส่งสาธารณะนี้
color
ประเภท:  string
สีที่ใช้กันโดยทั่วไปในป้ายของเส้นทางขนส่งสาธารณะนี้ โดยแสดงเป็นรหัสเลขฐานสิบหก
icon
ประเภท:  string
URL สำหรับไอคอนที่เชื่อมโยงกับเส้นนี้
name
ประเภท:  string
ชื่อเต็มของสายการขนส่งสาธารณะนี้ เช่น "8 Avenue Local"
short_name
ประเภท:  string
ชื่อย่อของเส้นทางขนส่งสาธารณะนี้ เช่น "E"
text_color
ประเภท:  string
สีข้อความที่ใช้กันโดยทั่วไปในป้ายของเส้นทางขนส่งสาธารณะนี้ โดยแสดงเป็นรหัสเลขฐานสิบหก
url
ประเภท:  string
URL ของเอเจนซีซึ่งใช้สำหรับสายการขนส่งสาธารณะนี้โดยเฉพาะ
vehicle
ประเภท:  TransitVehicle
ประเภทยานพาหนะที่ใช้ เช่น รถไฟหรือรถประจำทาง

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

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

ข้อมูลเกี่ยวกับหน่วยงานที่ดำเนินการเส้นทางขนส่งสาธารณะ

name
ประเภท:  string
ชื่อของบริษัทขนส่งนี้
phone
ประเภท:  string
หมายเลขโทรศัพท์ของบริษัทขนส่ง
url
ประเภท:  string
URL ของบริษัทขนส่ง

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

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

ข้อมูลเกี่ยวกับยานพาหนะที่ปฏิบัติงานบนเส้นทางขนส่งสาธารณะ

icon
ประเภท:  string
URL ของไอคอนที่สอดคล้องกับประเภทของพาหนะที่ใช้ในเส้นนี้
local_icon
ประเภท:  string
URL สำหรับไอคอนที่สอดคล้องกับประเภทของยานพาหนะที่ใช้ในภูมิภาคนี้แทนที่จะเป็นไอคอนทั่วไป
name
ประเภท:  string
ชื่อของขนส่งสาธารณะประเภทนี้ เช่น "รถไฟ" หรือ "รถประจำทาง"
type
ประเภท:  VehicleType
ประเภทยานพาหนะที่ใช้ เช่น รถไฟ รถประจำทาง หรือเรือข้ามฟาก

ค่าคงที่ VehicleType

ค่าคงที่ google.maps.VehicleType

ค่าที่เป็นไปได้สำหรับประเภทยานพาหนะ

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

BUS รถประจำทาง
CABLE_CAR ยานพาหนะที่ใช้สายเคเบิล ซึ่งโดยปกติอยู่บนพื้นดิน กระเช้าลอยฟ้าอาจเป็นประเภท GONDOLA_LIFT
COMMUTER_TRAIN รถไฟโดยสาร
FERRY เรือข้ามฟาก
FUNICULAR ยานพาหนะที่ดึงขึ้นจากทางลาดชันโดยใช้สายเคเบิล
GONDOLA_LIFT กระเช้าลอยฟ้า
HEAVY_RAIL รถไฟหนัก
HIGH_SPEED_TRAIN รถไฟความเร็วสูง
INTERCITY_BUS รถโดยสารระหว่างเมือง
METRO_RAIL รถไฟฟ้ารางเบา
MONORAIL รถไฟรางเดี่ยว
OTHER ยานพาหนะอื่นๆ
RAIL รถไฟ
SHARE_TAXI แท็กซี่โดยสารร่วมคือบริการขนส่งรถบัสประเภทหนึ่ง ที่สามารถส่งคืนและรับผู้โดยสารได้จากทุกที่บนเส้นทาง แท็กซี่มักจะใช้รถมินิบัสร่วมกัน
SUBWAY รถไฟฟ้ารางเบาใต้ดิน
TRAM รถไฟฟ้ารางเบาเหนือพื้น
TROLLEYBUS รถรางไฟฟ้า

ค่าคงที่ UnitSystem

ค่าคงที่ google.maps.UnitSystem

ระบบหน่วยที่ถูกต้องซึ่งสามารถระบุใน DirectionsRequest

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

IMPERIAL ระบุว่าระยะทางใน DirectionsResult ควรแสดงเป็นหน่วยอิมพีเรียล
METRIC ระบุว่าระยะทางใน DirectionsResult ควรแสดงเป็นหน่วยเมตริก

อินเทอร์เฟซระยะทาง

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

การแสดงระยะทางเป็นค่าตัวเลขและสตริงการแสดงผล

text
ประเภท:  string
ตัวแทนสตริงของค่าระยะทางโดยใช้ UnitSystem ที่ระบุในคําขอ
value
ประเภท:  number
ระยะทางเป็นเมตร

อินเทอร์เฟซ ระยะเวลา

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

การแสดงระยะเวลาเป็นค่าตัวเลขและสตริงการแสดงผล

text
ประเภท:  string
การแสดงสตริงของค่าระยะเวลา
value
ประเภท:  number
ระยะเวลาเป็นวินาที

อินเทอร์เฟซเวลา

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

การแสดงเวลาเป็นออบเจ็กต์วันที่ สตริงที่แปลแล้ว และเขตเวลา

text
ประเภท:  string
สตริงที่แสดงค่าของเวลา ระบบจะแสดงเวลาเป็นเขตเวลาของป้ายจอดรถ
time_zone
ประเภท:  string
เขตเวลาที่ป้ายหยุดนี้ตั้งอยู่ ค่านี้คือชื่อของเขตเวลาตามที่ระบุไว้ในฐานข้อมูลเขตเวลาของ IANA เช่น "America/New_York"
value
ประเภท:  Date
เวลาออกเดินทางหรือมาถึงนี้ ระบุเป็นออบเจ็กต์วันที่ของ JavaScript

ค่าคงที่ DirectionsTravelMode

ค่าคงที่ google.maps.DirectionsTravelMode

ค่าคงที่ DirectionsUnitSystem

ค่าคงที่ google.maps.DirectionsUnitSystem