Directions

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คลาส DirectionsService

google.maps.DirectionsService ชั้น

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

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

เส้นทางสถานะ

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

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

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 ทางอ้อม

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

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
ค่าที่ส่งคืน: ไม่มี
ตั้งค่าดัชนี (แบบ 0) ของเส้นทางในออบเจ็กต์ 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 ขา วิธีนี้มีประโยชน์ถ้าคุณต้องการสร้างเส้นทางเพื่อตอบสนองต่อจุดชี้เมาส์ที่ผู้ใช้ลากบนแผนที่

อินเทอร์เฟซ Directions GeocodingWaypoint

อินเทอร์เฟซ 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 ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับขั้นตอนที่ใช้ในการเขียน แต่ละจุดสําหรับจุดแวะพักหรือจุดหมายแต่ละแห่งจะระบุ ดังนั้นเส้นทางที่ไม่มีจุดแวะพักแวะจะมี DirectionsLeg เส้นทาง 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 ช่องนี้จะมีลําดับการจัดเรียงใหม่จากลําดับการส่ง เช่น หากอินพุตคือ
ต้นทาง: ลอสแอนเจลิส
Waypoints: Dallas, Bangor, Phoenix
Destination: New York
และเอาต์พุตที่เพิ่มประสิทธิภาพเรียงลําดับดังนี้
Origin: Los Angeles
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

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

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

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

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

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

รูปแบบการเข้าชม ค่าคงที่

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

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

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

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

ค่าคงที่ TransitRoutePreferences

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

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

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

อินเทอร์เฟซ 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
ประเภทของยานพาหนะที่ใช้ เช่น รถไฟหรือรถประจําทาง

อินเทอร์เฟซ แผนการเดินทาง

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

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

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

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

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

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

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

ค่าคงที่ VehicleType

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

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

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

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 เช่น "อเมริกา/นิว_ยอร์ค"
value
ประเภท: Date
เวลาออกเดินทางนี้หรือมาถึง ซึ่งระบุเป็นออบเจ็กต์วันที่ของ JavaScript

ค่าคงที่ DirectionsTravelMode

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

ค่าคงที่ DirectionsUnitSystem

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