ตั้งค่าจุดอ้างอิงระดับกลาง

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

จุดแวะพักระหว่างทางคือสถานที่ที่ระบุไว้ระหว่างต้นทางกับปลายทางที่คุณต้องการให้เส้นทางผ่าน

คุณกำหนดจุดแวะพักระหว่างทางได้สูงสุด 25 จุด ในคำขอเดียวโดยใช้พร็อพเพอร์ตี้อาร์เรย์ intermediates ของเมธอด REST computeRoutes หรือเมธอด gRPC ComputeRoutes

จุดแวะพักเทียบกับจุดแวะพักระหว่างทาง

คุณกำหนดค่าจุดแวะพักระหว่างทางให้เป็นจุดแวะพักหรือจุดแวะพักระหว่างทางได้

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

ช่วงเส้นทางและจุดแวะพักระหว่างทาง

สำหรับการแวะพักระหว่างทางแต่ละจุดในคำขอ การตอบกลับจะมี แยกต่างหาก RouteLeg ออบเจ็กต์ ในอาร์เรย์ routes.legs

ตัวอย่างเช่น เส้นทางที่มีต้นทาง จุดแวะพักระหว่างทาง 1 จุด และปลายทางจะมี ช่วงเส้นทาง 2 ช่วง: * ช่วงที่ 1: จากต้นทางไปยังจุดแวะพักระหว่างทาง * ช่วงที่ 2: จากจุดแวะพักระหว่างทางไปยังปลายทาง

ตัวอย่าง: คำขอที่มีจุดแวะพักระหว่างทาง

ตัวอย่างต่อไปนี้ใช้พร็อพเพอร์ตี้อาร์เรย์ intermediates เพื่อเพิ่มจุดแวะพักระหว่างทาง 1 จุดลงในเส้นทาง

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'

การตอบกลับที่มีช่วงเส้นทางหลายช่วง

เนื่องจากจุดแวะพักระหว่างทางในคำขอเป็นจุดแวะพักที่ไม่ได้ ตั้งค่า "via": true การตอบกลับจึงแบ่งเส้นทางออกเป็น 2 ช่วงในอาร์เรย์ legs ดังนี้

{
  "routes": [
    {
      "distanceMeters": 805,
      "duration": "248s",
      "legs": [
        {
          "distanceMeters": 207,
          "duration": "89s",
          "startLocation": {
            "latLng": {
              "latitude": 37.4197318,
              "longitude": -122.0826233
            }
          },
          "endLocation": {
            "latLng": {
              "latitude": 37.419734,
              "longitude": -122.0807792
            }
          }
        },
        {
          "distanceMeters": 598,
          "duration": "159s",
          "startLocation": {
            "latLng": {
              "latitude": 37.419734,
              "longitude": -122.0807792
            }
          },
          "endLocation": {
            "latLng": {
              "latitude": 37.4176166,
              "longitude": -122.0793882
            }
          }
        }
      ]
    }
  ]
}