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 โดยอ้อม
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

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

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

อินเทอร์เฟซ 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
ประเภท:  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 และยังดึงรหัสสถานที่จากคําขอไปยัง 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

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

เข้าถึงได้โดยโทรหา 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
รูปแบบการเดินทางที่ต้องการ เช่น รถประจําทางหรือรถไฟ หากไม่กําหนด 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 ระบุรถรางเป็นโหมดการเดินทางที่ต้องการ

ค่าคงที่ TransitRoutePreferences

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
ชื่อของป้ายจอดรถนี้

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

อินเทอร์เฟซ 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 ค่าคงที่

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

เข้าถึงได้โดยโทรหา 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 ค่าคงที่