ผลิตภัณฑ์นี้มีสถานะเดิม ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป คุณจะไม่สามารถเปิดใช้ Directions API (เดิม) สำหรับโปรเจ็กต์ Google Cloud ใหม่ได้อีกต่อไป โปรเจ็กต์ที่มีอยู่จะยังคงได้รับการสนับสนุนอย่างเต็มรูปแบบ ย้ายข้อมูลไปยัง Routes API เพื่อรับฟีเจอร์ใหม่และประสิทธิภาพที่ดียิ่งขึ้น

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ตัวอย่างเส้นทาง

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

ผลิตภัณฑ์นี้อยู่ในสถานะเดิม ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป คุณจะไม่สามารถเปิดใช้ Directions API (เดิม) สำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่ได้อีกต่อไป โปรเจ็กต์ที่มีอยู่จะยังคงได้รับการสนับสนุนอย่างเต็มรูปแบบ หากต้องการใช้ฟีเจอร์ใหม่และประสิทธิภาพที่ดีขึ้น โปรดย้ายข้อมูลไปยัง Routes API

ตัวอย่างคำขอ

คำขอต่อไปนี้จะแสดงเส้นทางการขับขี่จากโทรอนโต รัฐออนแทรีโอไปยังมอนทรีออล รัฐควิเบก

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

การเปลี่ยนพารามิเตอร์ mode และ avoid จะช่วยให้คุณแก้ไขคำขอเริ่มต้นเพื่อแสดงเส้นทางสำหรับการเดินทางด้วยจักรยานที่สวยงามซึ่งหลีกเลี่ยงทางหลวงสายหลักได้

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

คำขอต่อไปนี้จะค้นหาเส้นทางขนส่งสาธารณะจากบรูคลิน นิวยอร์กไปยังควีนส์ นิวยอร์ก คำขอไม่ได้ระบุ departure_time ดังนั้นเวลาออกเดินทางจึงเป็นเวลาปัจจุบันโดยค่าเริ่มต้น

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

คำขอขนส่งสาธารณะต่อไปนี้มีเวลาออกเดินทางที่เฉพาะเจาะจง

หมายเหตุ: ในตัวอย่างนี้ เวลาออกเดินทางระบุเป็นวันที่ 30 กรกฎาคม 2012 เวลา 09:45 น. คุณต้องเปลี่ยนพารามิเตอร์เป็นเวลาในอนาคตก่อนส่งคำขอเพื่อหลีกเลี่ยงข้อผิดพลาด

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

คำขอต่อไปนี้ใช้ Plus Code เพื่อแสดงเส้นทางการขับขี่จาก H8MW+WP ไปยัง GCG2+3M ในโกลกาตา ประเทศอินเดีย

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

คำขอต่อไปนี้จะแสดงเส้นทางการขับขี่จากกลาสโกว์ สหราชอาณาจักรไปยังเพิร์ท สหราชอาณาจักรโดยใช้รหัสสถานที่

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

รูปแบบการเดินทาง

เมื่อคำนวณเส้นทาง คุณสามารถระบุmodeการขนส่งที่จะใช้ได้ โดยค่าเริ่มต้น ระบบจะคำนวณเส้นทางเป็นเส้นทางdriving ระบบรองรับโหมดการเดินทางต่อไปนี้

driving (ค่าเริ่มต้น) หมายถึงเส้นทางการขับขี่มาตรฐานโดยใช้เครือข่ายถนน
walking ขอเส้นทางเดินเท้าผ่านทางเท้าและทางเดิน (หากมี)
bicycling ขอเส้นทางการปั่นจักรยานผ่านเส้นทางจักรยานและถนนที่ต้องการ (หากมี)
transit ขอเส้นทางผ่านเส้นทางขนส่งสาธารณะ (หากมี) หากตั้งค่าโหมดเป็น transit คุณจะระบุ departure_time หรือ arrival_time ก็ได้ (ไม่บังคับ) หากไม่ได้ระบุเวลาทั้ง 2 รายการ departure_time จะใช้ค่าเริ่มต้นเป็นเวลาปัจจุบัน (นั่นคือ เวลาออกเดินทางจะใช้ค่าเริ่มต้นเป็นเวลาปัจจุบัน) นอกจากนี้ คุณยังเลือกที่จะรวม transit_mode และ/หรือ transit_routing_preference ด้วยก็ได้

หมายเหตุ: บางครั้งเส้นทางการเดินและเส้นทางการปั่นจักรยานอาจไม่มีทางเท้าหรือทางจักรยานที่ชัดเจน ดังนั้นเส้นทางเหล่านี้จะแสดง warnings ในผลลัพธ์ที่แสดงซึ่งคุณต้องแสดงให้ผู้ใช้เห็น

ข้อมูลการจราจร

ระบบจะใช้ข้อมูลการจราจรเมื่อเป็นไปตามเงื่อนไขต่อไปนี้ทั้งหมด (เงื่อนไขเหล่านี้จำเป็นต่อการรับช่อง duration_in_traffic ในการตอบกลับเส้นทาง)

พารามิเตอร์ travel mode คือ driving หรือไม่ได้ระบุ (driving คือรูปแบบการเดินทางเริ่มต้น)
คำขอมี พารามิเตอร์ departure_time ที่ถูกต้อง คุณสามารถตั้งค่า departure_time เป็นเวลาปัจจุบันหรือเวลาในอนาคตได้ โดยต้องไม่เป็นวันที่ในอดีต
คำขอไม่มีจุดอ้างอิงจุดแวะพัก หากคำขอมีจุดอ้างอิง ให้ใส่คำนำหน้าจุดอ้างอิงแต่ละจุดด้วย via: เพื่อกำหนดเส้นทางแต่หลีกเลี่ยงการแวะพัก ตัวอย่างเช่น
```
&waypoints=via:San Francisco|via:Mountain View|...
```

คุณสามารถใส่พารามิเตอร์ traffic_model ในคำขอเพื่อระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการจราจรได้

URL ต่อไปนี้จะเริ่มคำขอเส้นทางสำหรับการเดินทางจากบอสตัน รัฐแมสซาชูเซตส์ไปยังคอนคอร์ด รัฐแมสซาชูเซตส์ ผ่านชาร์ลสทาวน์และเล็กซิงตัน คำขอมีเวลาออกเดินทาง ซึ่งเป็นไปตามข้อกำหนดทั้งหมดในการแสดงผลฟิลด์ duration_in_traffic ในการตอบกลับเส้นทาง

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

จุดบนเส้นทาง

เมื่อคำนวณเส้นทางโดยใช้ Directions API (เดิม) คุณสามารถระบุจุดอ้างอิงเพื่อแสดงผลเส้นทางที่มีการผ่านหรือแวะพักที่สถานที่ระหว่างทาง คุณสามารถเพิ่มจุดอ้างอิงลงในเส้นทางการขับขี่ การเดิน หรือเส้นทางจักรยานได้ แต่จะเพิ่มลงในเส้นทางขนส่งสาธารณะไม่ได้

ระบุสถานที่ในพารามิเตอร์ `waypoints`

คุณสามารถระบุสถานที่ตั้งอย่างน้อย 1 แห่งโดยคั่นด้วยอักขระไปป์ (| หรือ %7C) ในรูปแบบรหัสสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูด โดยค่าเริ่มต้น บริการเส้นทางจะคำนวณเส้นทางโดยใช้จุดอ้างอิงตามลำดับที่ระบุ ลำดับความสำคัญในการแยกวิเคราะห์ค่าของจุดอ้างอิงคือรหัสสถานที่ พิกัดละติจูด/ลองจิจูด แล้วจึงตามด้วยที่อยู่

หากคุณส่งรหัสสถานที่ คุณต้องใส่คำนำหน้าเป็น place_id: คุณสามารถดึงรหัสสถานที่จาก Geocoding API และ Places API (รวมถึง Place Autocomplete) ดูตัวอย่างการใช้รหัสสถานที่จาก Place Autocomplete ได้ที่การเติมข้อความอัตโนมัติสำหรับสถานที่และเส้นทาง ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมของรหัสสถานที่
ใช้รหัสสถานที่เมื่อเป็นไปได้เพื่อประสิทธิภาพและความแม่นยำ รหัสเหล่านี้มีความชัดเจนไม่ซ้ำกัน เช่น คู่ค่าละติจูด/ลองจิจูด และให้ประโยชน์ในการเข้ารหัสพิกัดภูมิศาสตร์สำหรับการกำหนดเส้นทาง เช่น จุดเข้าถึงและตัวแปรการจราจร รหัสไม่จำเป็นต้องใช้บริการเพื่อทำการค้นหาหรือคำขอระดับกลางสำหรับรายละเอียดสถานที่ ซึ่งต่างจากที่อยู่ ดังนั้นประสิทธิภาพจึงดีกว่า
หากคุณส่งพิกัดละติจูด/ลองจิจูด ค่าดังกล่าวจะส่งไปยังเซิร์ฟเวอร์ฟรอนท์เอนด์โดยตรงเพื่อคำนวณเส้นทางโดยไม่ต้องเข้ารหัสพิกัดภูมิศาสตร์ ระบบจะจัดจุดให้ตรงกับถนนและอาจไม่ให้ความแม่นยำที่แอปของคุณต้องการ ใช้พิกัดเมื่อคุณมั่นใจว่าค่าดังกล่าวระบุจุดที่แอปต้องการสำหรับการกำหนดเส้นทางอย่างแท้จริง โดยไม่คำนึงถึงจุดเข้าถึงที่เป็นไปได้หรือรายละเอียดการเข้ารหัสพิกัดภูมิศาสตร์เพิ่มเติม ตรวจสอบว่าค่าละติจูดและลองจิจูดคั่นด้วยคอมมา (%2C) ไม่ใช่เว้นวรรค (%20)
หากคุณส่งที่อยู่ บริการเส้นทางจะเข้ารหัสพิกัดภูมิศาสตร์สตริงและแปลงเป็นพิกัดละติจูด/ลองจิจูดเพื่อคำนวณเส้นทาง หากค่าที่อยู่ไม่ชัดเจน ค่าดังกล่าวอาจทำให้เกิดการค้นหาเพื่อแก้ความกำกวมจากที่อยู่ที่คล้ายกัน เช่น "1st Street" อาจเป็นค่าที่สมบูรณ์หรือค่าบางส่วนสำหรับ "1st street NE" หรือ "1st St SE" ผลลัพธ์นี้อาจแตกต่างจากผลลัพธ์ที่ Geocoding API แสดงผล คุณหลีกเลี่ยงการตีความผิดที่อาจเกิดขึ้นได้โดยใช้รหัสสถานที่ ดูการแก้ปัญหาผลลัพธ์ของคำขอเส้นทาง

หรือจะระบุชุดจุดที่เข้ารหัสโดยใช้อัลกอริทึมเส้นประกอบที่เข้ารหัสก็ได้ คุณจะพบว่าชุดที่เข้ารหัสมีประโยชน์สำหรับจุดอ้างอิงจำนวนมาก เนื่องจาก URL จะสั้นลงอย่างมาก บริการบนเว็บทั้งหมดมีขีดจำกัด URL อยู่ที่ 16,384 อักขระ

เส้นประกอบที่เข้ารหัสต้องขึ้นต้นด้วย enc: และตามด้วยโคลอน (:) เช่น waypoints=enc:gfo}EtohhU:
นอกจากนี้ คุณยังรวมเส้นประกอบที่เข้ารหัสหลายเส้นได้โดยคั่นด้วยอักขระไปป์ (|) เช่น waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

URL ต่อไปนี้จะเริ่มคำขอเส้นทางสำหรับการเดินทางระหว่างบอสตัน รัฐแมสซาชูเซตส์ และคอนคอร์ด รัฐแมสซาชูเซตส์ โดยแวะพักที่ชาร์ลสทาวน์และเล็กซิงตันตามลำดับ ตัวอย่างนี้ใช้ที่อยู่ต่อไปนี้

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

กำหนดเส้นทางด้วยจุดแวะพักและจุดผ่าน

สำหรับจุดอ้างอิงแต่ละจุดในคำขอ การตอบกลับเส้นทางจะเพิ่มรายการลงในอาร์เรย์ legs เพื่อระบุรายละเอียดสำหรับการแวะพักในการเดินทางช่วงนั้น

หากต้องการกำหนดเส้นทางโดยใช้จุดอ้างอิงโดยไม่เพิ่มจุดแวะพัก ให้เพิ่มคำนำหน้า via: ลงในจุดอ้างอิง จุดอ้างอิงที่ขึ้นต้นด้วย via: จะไม่เพิ่มรายการลงในอาร์เรย์ legs แต่จะกำหนดเส้นทางการเดินทางผ่านจุดอ้างอิง

URL ต่อไปนี้จะแก้ไขคำขอก่อนหน้าเพื่อให้เส้นทางผ่านเล็กซิงตันโดยไม่หยุดพัก

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

คำนำหน้า via: จะมีประสิทธิภาพมากที่สุดเมื่อสร้างเส้นทางเพื่อตอบสนองต่อการที่ผู้ใช้ลากจุดอ้างอิงบนแผนที่ การดำเนินการนี้ช่วยให้ผู้ใช้เห็นลักษณะของเส้นทางสุดท้ายแบบเรียลไทม์ และช่วยให้มั่นใจได้ว่าจุดอ้างอิงจะอยู่ในตำแหน่งที่ Directions API (เดิม) เข้าถึงได้

ข้อควรระวัง: การใช้คำนำหน้า via: เพื่อหลีกเลี่ยงการแวะพักจะส่งผลให้คำแนะนำเส้นทางตีความจุดอ้างอิงอย่างเคร่งครัด การตีความนี้อาจส่งผลให้เกิดการอ้อมเส้นทางอย่างมากหรือ ZERO_RESULTS ในรหัสสถานะการตอบกลับหาก Directions API (เดิม) ไม่สามารถสร้างเส้นทางผ่านจุดนั้นได้

URL ต่อไปนี้จะขอจุดอ้างอิงโดยใช้พิกัดละติจูด/ลองจิจูด

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

ต่อไปนี้เป็นคำขอเดียวกันที่ใช้เส้นประกอบที่เข้ารหัส

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

โปรดทราบว่าคุณสามารถผสมตัวระบุ via: กับตัวแก้ไขตำแหน่งได้อย่างอิสระ เช่น

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

เพิ่มประสิทธิภาพจุดอ้างอิง

โดยค่าเริ่มต้น บริการเส้นทางจะคำนวณเส้นทางผ่านจุดอ้างอิงที่ระบุตามลำดับที่ระบุ คุณสามารถส่ง optimize:true เป็นอาร์กิวเมนต์แรกภายในพารามิเตอร์ waypoints เพื่ออนุญาตให้บริการเส้นทางเพิ่มประสิทธิภาพเส้นทางที่ระบุโดยจัดเรียงจุดอ้างอิงใหม่ตามลำดับที่มีประสิทธิภาพมากขึ้นได้ (ไม่บังคับ) (การเพิ่มประสิทธิภาพนี้เป็นการประยุกต์ใช้ ปัญหาพนักงานขายเดินทาง) ระยะเวลาเดินทางเป็นปัจจัยหลักที่ได้รับการเพิ่มประสิทธิภาพ แต่ปัจจัยอื่นๆ เช่น ระยะทาง จำนวนการเลี้ยว และอื่นๆ อีกมากมายอาจได้รับการพิจารณาเมื่อตัดสินใจว่าเส้นทางใดมีประสิทธิภาพมากที่สุด จุดอ้างอิงทั้งหมดต้องเป็นจุดแวะพักเพื่อให้ Directions Service เพิ่มประสิทธิภาพเส้นทางได้

หากคุณสั่งให้บริการเส้นทางเพิ่มประสิทธิภาพลำดับของจุดอ้างอิง ระบบจะแสดงลำดับของจุดอ้างอิงในช่อง waypoint_order ภายในออบเจ็กต์ routes ช่อง waypoint_order จะแสดงผลค่าที่อิงตาม 0

ตัวอย่างต่อไปนี้จะคำนวณการเดินทางบนท้องถนนจากแอดิเลด รัฐเซาท์ออสเตรเลียไปยังแหล่งผลิตไวน์หลักแต่ละแห่งของรัฐเซาท์ออสเตรเลียโดยใช้การเพิ่มประสิทธิภาพเส้นทาง

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

การตรวจสอบเส้นทางที่คำนวณจะระบุว่าการคำนวณใช้จุดอ้างอิงตามลำดับจุดอ้างอิงต่อไปนี้

"waypoint_order": [ 3, 2, 0, 1 ]

ข้อจำกัด

ระบบอาจคำนวณเส้นทางตามข้อจำกัดบางอย่าง ข้อจำกัดจะระบุโดยใช้พารามิเตอร์ avoid และอาร์กิวเมนต์ของพารามิเตอร์นั้นที่ระบุข้อจำกัดที่ควรหลีกเลี่ยง ระบบรองรับข้อจำกัดต่อไปนี้

avoid=tolls
avoid=highways
avoid=ferries

คุณสามารถขอเส้นทางที่เลี่ยงการผสมผสานระหว่างค่าผ่านทาง ทางหลวง และเรือข้ามฟากได้โดยส่งข้อจำกัดทั้ง 2 รายการไปยังพารามิเตอร์ avoid ตัวอย่างเช่น avoid=tolls|highways|ferries

หมายเหตุ: การเพิ่มข้อจำกัดไม่ได้เป็นการกีดกันเส้นทางที่มีฟีเจอร์ที่ถูกจำกัด แต่จะให้น้ำหนักกับผลลัพธ์ของเส้นทางที่เหมาะสมมากกว่า

ระบบหน่วยวัด

ผลลัพธ์ของเส้นทางมีช่อง text ภายใน distance ที่อาจแสดงต่อผู้ใช้เพื่อระบุระยะทางของ "ขั้นตอน" หนึ่งๆ ของเส้นทาง โดยค่าเริ่มต้น ข้อความนี้จะใช้ระบบหน่วยของประเทศหรือภูมิภาคต้นทาง

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

metric ระบุการใช้ระบบเมตริก ระบบจะแสดงระยะทางแบบข้อความเป็นกิโลเมตรและเมตร
imperial ระบุการใช้ระบบอิมพีเรียล (อังกฤษ) ระบบจะแสดงระยะทางเป็นข้อความโดยใช้หน่วยไมล์และฟุต

หมายเหตุ: การตั้งค่าระบบหน่วยนี้จะมีผลกับtextที่แสดงในช่อง distance เท่านั้น ช่อง distance ยังมี values ซึ่งแสดงเป็นเมตรเสมอ

การให้น้ำหนักพิเศษกับบางภูมิภาค

คุณสามารถตั้งค่าบริการเส้นทางให้แสดงผลลัพธ์จากภูมิภาคที่เฉพาะเจาะจงได้โดยใช้พารามิเตอร์ region พารามิเตอร์นี้จะใช้อาร์กิวเมนต์ ccTLD (โดเมนระดับบนสุดแบบรหัสประเทศ) แบบ 2 อักขระที่ระบุการให้น้ำหนักพิเศษกับบางภูมิภาค รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 alpha-2 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

คุณสามารถใช้โดเมนใดก็ได้ที่แอปพลิเคชัน Google Maps หลักเปิดตัวเส้นทางการขับขี่

ตัวอย่างเช่น คำขอเส้นทางจาก "Toledo" ไปยัง "Madrid" จะแสดงผลลัพธ์ที่เหมาะสมเมื่อตั้งค่า region เป็น es และระบบจะตีความ "Toledo" เป็นเมืองในสเปน ดังนี้

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

คำขอเส้นทางสำหรับ "Toledo" ไปยัง "Madrid" ที่ส่งโดยไม่มีพารามิเตอร์ region จะไม่แสดงผลลัพธ์ เนื่องจากระบบตีความ "Toledo" เป็นเมืองในรัฐโอไฮโอ ไม่ใช่สเปน ดังนี้

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

ตัวปรับแต่งสถานที่ตั้ง

คุณสามารถใช้ตัวแก้ไขตำแหน่งเพื่อระบุวิธีที่คนขับควรเข้าใกล้ตำแหน่งหนึ่งๆ โดยใช้พารามิเตอร์ side_of_road เพื่อระบุฝั่งถนนที่จะใช้ หรือระบุทิศทางเพื่อระบุทิศทางการเดินทางที่ถูกต้อง ตัวแก้ไขเหล่านี้อาจผสมกับตัวแก้ไข via: สำหรับจุดอ้างอิงระดับกลางได้อย่างอิสระ

ระบุว่าเส้นทางต้องผ่านด้านใดด้านหนึ่งของถนน

เมื่อระบุจุดอ้างอิง คุณสามารถขอให้เส้นทางผ่านด้านใดด้านหนึ่งของถนนที่จุดอ้างอิงให้น้ำหนักได้โดยใช้คำนำหน้า side_of_road: ตัวอย่างเช่น คำขอเส้นทางนี้จะแสดงผลเส้นทางที่ยาวเพื่อให้ยานพาหนะสิ้นสุดที่ฝั่งถนนที่จุดอ้างอิงมีความเอนเอียง

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

เมื่อใช้ side_of_road: กับเส้นประกอบที่เข้ารหัส ระบบจะใช้พารามิเตอร์กับทุกตำแหน่งตามเส้นประกอบ

ตัวแก้ไข side_of_road: ใช้ได้เฉพาะกับข้อจำกัดต่อไปนี้

พารามิเตอร์ travel mode คือ driving หรือไม่ได้ระบุ (driving เป็นรูปแบบการเดินทางเริ่มต้น)

ระบุว่าเส้นทางควรมีทิศทางที่เฉพาะเจาะจง

เมื่อระบุจุดอ้างอิง คุณสามารถขอให้เส้นทางผ่านจุดอ้างอิงในทิศทางที่เฉพาะเจาะจงได้ ส่วนหัวนี้ระบุด้วยคำนำหน้า heading=X: โดยที่ X คือค่าองศาจำนวนเต็มระหว่าง 0 (รวม) ถึง 360 (ไม่รวม) ทิศทาง 0 หมายถึงทิศเหนือ 90 หมายถึงทิศตะวันออก โดยนับตามเข็มนาฬิกา ตัวอย่างเช่น ในคำขอเส้นทางนี้ เส้นทางจะมุ่งไปทางตะวันออกจากจุดเริ่มต้น แล้วกลับรถ

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

ตัวแก้ไข heading=X: ใช้ได้เฉพาะเมื่อมีข้อจำกัดต่อไปนี้

พารามิเตอร์ travel mode คือ driving, bicycling หรือไม่ได้ระบุ (driving คือรูปแบบการเดินทางเริ่มต้น)
ไม่ได้ระบุตัวแก้ไข side_of_road สำหรับสถานที่ตั้งเดียวกัน
โดยระบุตำแหน่งด้วยค่าละติจูด/ลองจิจูด คุณไม่สามารถใช้ heading กับที่อยู่, รหัสสถานที่ หรือเส้นประกอบที่เข้ารหัส

ตัวอย่างคำขอ

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

รูปแบบการเดินทาง

ข้อมูลการจราจร

URL

curl

จุดบนเส้นทาง

ระบุสถานที่ในพารามิเตอร์ waypoints

URL

curl

กำหนดเส้นทางด้วยจุดแวะพักและจุดผ่าน

URL

curl

URL

curl

URL

curl

URL

curl

เพิ่มประสิทธิภาพจุดอ้างอิง

URL

curl

ข้อจำกัด

ระบบหน่วยวัด

การให้น้ำหนักพิเศษกับบางภูมิภาค

URL

curl

JSON

XML

URL

curl

JSON

XML

ตัวปรับแต่งสถานที่ตั้ง

ระบุว่าเส้นทางต้องผ่านด้านใดด้านหนึ่งของถนน

URL

curl

ระบุว่าเส้นทางควรมีทิศทางที่เฉพาะเจาะจง

URL

curl

ระบุสถานที่ในพารามิเตอร์ `waypoints`