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

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

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

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

เพิ่มจุดแวะพักกลางทาง

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

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

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

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

ตัวอย่าง: เพิ่มจุดอ้างอิงกลาง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งจุดแวะระหว่างเส้นทางโดยการเพิ่ม จุดอ้างอิงกลางใน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: 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'

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