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 เท่านั้น ออบเจ็กต์นี้จะไม่มีผลกับโหมดการเดินทางอื่นๆ
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

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 ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับขาและขั้นตอนที่ใช้ในการเขียน มีเพียง 1 เส้นทางเท่านั้นที่ตั้งค่าไว้ 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)
พารามิเตอร์:
  • panel: HTMLElement optional
ค่าการแสดงผล: ไม่มี
วิธีนี้จะแสดงผลเส้นทางใน <div> ส่ง null เพื่อนําเนื้อหาออกจากแผง
setRouteIndex
setRouteIndex(routeIndex)
พารามิเตอร์:
  • routeIndex: number
ค่าการแสดงผล: ไม่มี
ตั้งค่าดัชนี (ตามศูนย์) ของเส้นทางในออบเจ็กต์ 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|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
อาร์เรย์ของสตริงที่แสดงถึงประเภทขององค์ประกอบที่ระบุทางภูมิศาสตร์ซึ่งแสดงผลกลับมา ดูรายการสตริงที่เป็นไปได้ที่หัวข้อประเภทคอมโพเนนต์ที่อยู่ของคู่มือสําหรับนักพัฒนาซอฟต์แวร์

อินเทอร์เฟซเส้นทาง

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

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

bounds
ประเภท: LatLngBounds
ขอบเขตของเส้นทางนี้
copyrights
ประเภท: string
ข้อความลิขสิทธิ์ที่จะแสดงสําหรับเส้นทางนี้
legs
ประเภท: Array<DirectionsLeg>
อาร์เรย์ของ DirectionsLeg ซึ่งแต่ละรายการจะมีข้อมูลเกี่ยวกับขั้นตอนที่ใช้ในการเขียน แต่ละจุดแวะพักหรือจุดหมายแต่ละแห่งจะมี 1 ขา ดังนั้นเส้นทางที่ไม่มีจุดแวะพัก จะมี DirectionsLeg เส้นทางหนึ่งและเส้นทางที่มีจุดแวะพัก 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 ช่องนี้จะมีการจัดเรียงลําดับใหม่ของจุดอ้างอิง เช่น หากอินพุตเป็น
Origin: Los Angeles
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 เนื่องจากไม่ทราบระยะเวลา

อินเทอร์เฟซเส้นทาง

อินเทอร์เฟซ 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
ประเภท: Array<DirectionsStep> 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 และยังดึงรหัสสถานที่จากคําขอไปยัง Geocode API ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของรหัสสถานที่
query optional
ประเภท: string optional
คําค้นหาที่อธิบายสถานที่ (เช่น ธุรกิจหรือจุดสนใจ) ตัวอย่างคําค้นหาคือ "Quay, Upper Level, Overseas Paผู้โดยสาร 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 ระบุคําขอเส้นทางเดินเท้า

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

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

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

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

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

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

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

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

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

agencies
ประเภท: Array<TransitAgency>
บริษัทขนส่งที่ใช้เส้นทางขนส่งสาธารณะนี้
color
ประเภท: string
สีที่นิยมใช้ในป้ายขนส่งสําหรับเส้นทางขนส่งสาธารณะนี้ ซึ่งแสดงเป็นสตริงแบบเลขฐาน 16
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 ของบริษัทขนส่ง

อินเทอร์เฟซสําหรับขนส่งสาธารณะ

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

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

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

ค่าคงที่ของยานพาหนะ

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

ค่าที่เป็นไปได้สําหรับประเภทยานพาหนะ ค่าเหล่านี้ระบุเป็นสตริง เช่น "BUS" หรือ "TRAIN"

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