Directions

DirectionsService class

google.maps.DirectionsService class

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

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

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

DirectionsRequest interface

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 constants

google.maps.DirectionsStatus constants

สถานะที่ 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 class

google.maps.DirectionsRenderer class

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

DirectionsRendererOptions interface

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 ของ Static Maps API)
overview_polyline
ประเภท:  string
การนำเสนอเส้นประกอบที่เข้ารหัสของเส้นทางใน overview_path เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (ปรับให้เรียบ) ของเส้นทางที่ได้
summary
ประเภท:  string
มีคำอธิบายแบบข้อความสั้นๆ สำหรับเส้นทาง ซึ่งเหมาะสำหรับการตั้งชื่อและทำให้เส้นทางแตกต่างจากเส้นทางอื่นๆ อย่างชัดเจน
warnings
ประเภท:  Array<string>
คำเตือนที่จะแสดงเมื่อแสดงเส้นทางเหล่านี้
waypoint_order
ประเภท:  Array<number>
หากตั้งค่า optimizeWaypoints เป็น true ช่องนี้จะมีการเปลี่ยนลําดับใหม่ของจุดแวะพักที่ป้อน ตัวอย่างเช่น หากอินพุตคือ
  ต้นทาง: ลอสแอนเจลิส
  จุดแวะพัก: ดัลลัส แบงเกอร์ ฟีนิกซ์
  ปลายทาง: นิวยอร์ก
และเอาต์พุตที่ได้รับการเพิ่มประสิทธิภาพมีลําดับดังนี้
  ต้นทาง: ลอสแอนเจลิส
  จุดแวะพัก: ฟีนิกซ์ ดัลลัส แบงเกอร์
  ปลายทาง: นิวยอร์ก
ช่องนี้จะเป็น Array ที่มีค่า [2, 0, 1] โปรดทราบว่าการนับจุดแวะพักจะนับจาก 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 interface

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
ประกอบด้วยออบเจ็กต์ที่มีพร็อพเพอร์ตี้เดียว "points" ซึ่งเก็บการแสดงรูปหลายเหลี่ยมที่เข้ารหัสของขั้นตอน เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (ปรับให้เรียบ) ของขั้นตอน
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 constants

google.maps.TravelMode constants

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

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

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

DrivingOptions interface

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

กําหนดค่า DirectionsRequest เมื่อตั้งค่าโหมดการเดินทางเป็น DRIVING

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

TrafficModel constants

google.maps.TrafficModel constants

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

TransitMode constants

google.maps.TransitMode constants

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

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

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

TransitRoutePreference constants

google.maps.TransitRoutePreference constants

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

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

FEWER_TRANSFERS ระบุว่าเส้นทางที่คำนวณควรมีจำนวนการเปลี่ยนเส้นทางที่จำกัด
LESS_WALKING ระบุว่าเส้นทางที่คำนวณควรมีระยะทางในการเดินที่จำกัด

TransitFare interface

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

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

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

TransitDetails interface

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
ข้อความที่ปรากฏในตารางเวลาและป้ายบอกทางเพื่อระบุการเดินทางด้วยระบบขนส่งสาธารณะแก่ผู้โดยสาร เช่น เพื่อระบุหมายเลขรถไฟสำหรับการเดินทางด้วยรถไฟชานเมือง ข้อความจะระบุการเดินทางภายในวันให้บริการโดยไม่ซ้ำกัน

TransitStop interface

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

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

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

TransitLine interface

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

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

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

TransitAgency interface

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

ข้อมูลเกี่ยวกับบริษัทที่ดำเนินการเดินรถประจำทาง

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

TransitVehicle interface

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

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

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

VehicleType constants

google.maps.VehicleType constants

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

เข้าถึงโดยการโทรหา 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 constants

google.maps.UnitSystem constants

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

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

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

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

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

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

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

Duration interface

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

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

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

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

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

การนำเสนอเวลาในรูปแบบออบเจ็กต์ Date, สตริงที่แปลแล้ว และเขตเวลา

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

DirectionsTravelMode constants

google.maps.DirectionsTravelMode constants

DirectionsUnitSystem constants

google.maps.DirectionsUnitSystem constants