คุณสามารถกำหนดจุดแวะพักระหว่างเส้นทาง เช่น จุดรับหรือส่ง ได้ 2 วิธีดังนี้
- เพิ่มจุดอ้างอิงระหว่างทาง: ซึ่งจะเป็นตัวเลือกเริ่มต้น เพิ่มจุดอ้างอิงระหว่างทางระหว่างจุดเริ่มต้นและจุดหมายในอาร์เรย์
intermediatesเครื่องมือการกำหนดเส้นทางจะปักหมุดจุดอ้างอิงกับถนนที่สามารถสัญจรได้ที่ใกล้ที่สุด และแบ่งเส้นทางออกเป็นส่วนๆ ของRouteLegที่เชื่อมต่อกันด้วยจุดแวะพักดังกล่าว - ระบุ vehicleStopover: หากต้องการให้เครื่องมือการกำหนดเส้นทางทำการวิเคราะห์เพิ่มเติมเพื่อหลีกเลี่ยงส่วนของถนนที่ไม่เหมาะกับการจอด เช่น ทางหลวง อุโมงค์ หรือสะพานลอย ให้ตั้งค่า
vehicleStopover: trueในจุดอ้างอิง
เพิ่มจุดอ้างอิงระหว่างทาง
หากต้องการกำหนดจุดแวะพักระหว่างเส้นทาง ให้เพิ่มจุดอ้างอิงระหว่างทางลงในอาร์เรย์ intermediates ในคำขอ
การเพิ่มจุดอ้างอิงระหว่างทางจะส่งผลดังนี้
- เส้นทางจะแบ่งออกเป็น
RouteLegส่วน: แต่ละส่วนจะเชื่อมต่อจุดแวะพักหนึ่ง กับจุดแวะพักถัดไป - พิกัดจะปักหมุดกับถนน: เครื่องมือการกำหนดเส้นทางจะปักหมุดพิกัดละติจูด และลองจิจูดของคุณ ซึ่งอาจอยู่บนดาดฟ้าหรือในลาน ไปยัง ส่วนของถนนที่สามารถสัญจรได้ที่ใกล้ที่สุด
สำหรับถนนบนพื้นผิวหลายสาย การปักหมุดกับถนนที่ใกล้ที่สุดจะช่วยให้ได้ตำแหน่งแวะพักที่ใช้งานได้จริง อย่างไรก็ตาม การปักหมุดไม่ได้กำหนดว่าส่วนของถนนนั้นเหมาะกับการจอดข้างทางหรือไม่ เช่น เมื่อถนนที่ใกล้ที่สุดเป็นทางหลวงหรืออุโมงค์
ตัวอย่าง: เพิ่มจุดอ้างอิงระหว่างทาง
ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าจุดแวะพักระหว่างเส้นทางโดยการเพิ่มจุดอ้างอิงระหว่างทางในคำขอ computeRoutes POST
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
ดูข้อมูลเพิ่มเติมเกี่ยวกับจุดอ้างอิงระหว่างทางและส่วนของเส้นทางได้ที่หัวข้อตั้งค่า จุดอ้างอิงระหว่างทาง
ระบุ vehicleStopover เพื่อความเหมาะสมในการรับและส่ง
แม้ว่าจุดอ้างอิงระหว่างทางมาตรฐานจะปักหมุดกับถนนที่ใกล้ที่สุด แต่ถนนดังกล่าวอาจไม่เหมาะกับการจอดรถเสมอไป เมื่อต้องการให้เครื่องมือการกำหนดเส้นทางทำการวิเคราะห์เพิ่มเติมเพื่อประเมินความเหมาะสมของถนนสำหรับการรับหรือส่ง ให้ตั้งค่า vehicleStopover: true ในจุดอ้างอิง
เมื่อตั้งค่า vehicleStopover: true เครื่องมือการกำหนดเส้นทางจะประเมินส่วนของถนนที่อาจเป็นไปได้และพยายามหลีกเลี่ยงถนนที่ไม่เหมาะกับการจอด เช่น ทางด่วน อุโมงค์ และสะพานลอย
ตัวอย่างเช่น พิจารณาสถานที่ที่ถนนบนพื้นผิวผ่านเหนือทางหลวงภายในอุโมงค์โดยตรง: * จุดอ้างอิงระหว่างทางมาตรฐาน: ปักหมุดกับทางหลวงหรืออุโมงค์ ด้านล่างหากอยู่ใกล้กับพิกัดของคุณในเชิงเรขาคณิต * VehicleStopover: ทำการวิเคราะห์เพิ่มเติมเพื่อข้ามทางหลวง และอุโมงค์ โดยปักหมุดจุดแวะพักกับถนนบนพื้นผิวที่เหมาะกับการจอดข้างทาง
ตัวอย่าง: ระบุ vehicleStopover ในจุดอ้างอิง
ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่า vehicleStopover: true ในจุดอ้างอิงระหว่างทางในคำขอ POST ที่สมบูรณ์
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } }, "vehicleStopover": true } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทและตัวเลือกจุดอ้างอิงได้ที่หัวข้อ ประเภทและ ตัวเลือกจุดอ้างอิง