กําหนดจุดแวะระหว่างทาง

คุณตั้งค่าจุดแวะพักตามเส้นทางได้ เช่น สำหรับการรับหรือส่งผู้โดยสาร โดยทำได้ 2 วิธีดังนี้

• เพิ่มจุดแวะพักกลางทาง: นี่คือตัวเลือกเริ่มต้น เพิ่มจุดแวะพัก ระหว่างต้นทางและจุดหมายในอาร์เรย์ intermediates เครื่องมือการกำหนดเส้นทางจะยึดจุดอ้างอิงกับถนนที่นำทางได้ที่ใกล้ที่สุด และแบ่งเส้นทางออกเป็นRouteLegส่วนที่เชื่อมต่อกันด้วยจุดแวะพักนั้น
• ระบุ vehicleStopover: หากต้องการให้เครื่องมือการกำหนดเส้นทางทำการวิเคราะห์เพิ่มเติมเพื่อหลีกเลี่ยงส่วนของถนนที่ไม่เหมาะสำหรับการหยุด เช่น ทางหลวง อุโมงค์ หรือสะพานลอย ให้ตั้งค่า vehicleStopover: true ในจุดอ้างอิง

เพิ่มจุดอ้างอิงระหว่างทาง

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

การเพิ่มจุดแวะพักกลางทางจะมีผลดังนี้

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

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

ตัวอย่าง: เพิ่มจุดอ้างอิงระหว่างทาง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าจุดแวะพักตามเส้นทางโดยการเพิ่มจุดอ้างอิงระหว่างทางในคำขอ POST ของ computeRoutes

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: 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'

ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทและตัวเลือกของจุดอ้างอิงได้ที่ประเภทและตัวเลือกของจุดอ้างอิง