Directions

คลาส DirectionsService

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

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

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

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

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

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

การค้นหาเส้นทางไปที่ DirectionsService

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

ค่าคงที่ DirectionsStatus

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

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

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

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

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

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

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

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

คลาส DirectionsRenderer

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

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

ชั้นเรียนนี้จะขยายการให้บริการไปยัง MVCObject

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

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

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

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

ออบเจ็กต์นี้กำหนดคุณสมบัติที่ตั้งค่าในออบเจ็กต์ DirectionsRenderer ได้

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

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

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

DirectionsWaypoint แสดงตำแหน่งระหว่างต้นทางและปลายทางที่ควรใช้ในการกำหนดเส้นทางการเดินทาง

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

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

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

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

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

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

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

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

bounds
ประเภท:  LatLngBounds
ขอบเขตของเส้นทางนี้
copyrights
ประเภท:  string
ข้อความลิขสิทธิ์ที่จะแสดงสำหรับเส้นทางนี้
legs
ประเภท:  Array<DirectionsLeg>
อาร์เรย์ของ DirectionsLeg ซึ่งแต่ละอาร์เรย์จะมีข้อมูลเกี่ยวกับขั้นตอนในการสร้างโค้ดดังกล่าว แต่ละจุดแวะพักหรือจุดหมายที่ระบุไว้จะมี 1 ขา ดังนั้นเส้นทางที่ไม่มีจุดอ้างอิงจุดแวะจะมี DirectionsLeg 1 จุด และเส้นทางที่มีจุดแวะพัก 1 จุดจะมี 2 จุด
overview_path
ประเภท:  Array<LatLng>
อาร์เรย์ของ LatLng ที่แสดงถึงเส้นทางตลอดทั้งเส้นทาง ระบบจะปรับเส้นทางให้เรียบง่ายขึ้นเพื่อให้เหมาะสมกับบริบทที่ต้องมีจุดยอดเล็กน้อย (เช่น URL ของ Maps API แบบคงที่)
overview_polyline
ประเภท:  string
การนําเสนอโพลีไลน์ที่เข้ารหัสของเส้นทางในหน้าภาพรวม_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 โปรดทราบว่าจำนวนจุดอ้างอิงจะเริ่มด้วยศูนย์
หากจุดอ้างอิงอินพุตใดมีการตั้งค่า stopover เป็น false ช่องนี้จะว่างเปล่า เนื่องจากการเพิ่มประสิทธิภาพเส้นทางไม่พร้อมใช้งานสำหรับการค้นหาดังกล่าว
fare optional
ประเภท:  TransitFare optional
ค่าโดยสารรวมสำหรับการเดินทางด้วยขนส่งสาธารณะ ใช้ได้กับคำขอขนส่งสาธารณะเท่านั้น

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

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

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

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

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

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

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

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

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

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

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

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

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

วัตถุที่มีพร็อพเพอร์ตี้ points เพื่ออธิบายโพลีไลน์ของ DirectionsStep

points
ประเภท:  string

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

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

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

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

ค่าคงที่ TravelMode

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

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

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

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

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

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

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

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

ค่าคงที่ TrafficModel

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

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

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

BEST_GUESS ใช้ข้อมูลการเข้าชมที่ผ่านมาเพื่อประมาณเวลาที่ใช้ในการเข้าชมได้ดีที่สุด
OPTIMISTIC ใช้ข้อมูลการเข้าชมที่ผ่านมาเพื่อทำการประมาณอย่างเหมาะสมว่าระยะเวลาของการเข้าชมจะเป็นอย่างไร
PESSIMISTIC ใช้ข้อมูลการเข้าชมที่ผ่านมาเพื่อสร้างค่าประมาณทางลบของระยะเวลาการเข้าชม

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

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

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

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

ค่าคงที่ TransitMode

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

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

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

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

ค่าคงที่ 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
เวลาถึงของขั้นตอนนี้ ระบุเป็นออบเจ็กต์ 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
ประเภทยานพาหนะที่ใช้ เช่น รถไฟหรือรถประจำทาง

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

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

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

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