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

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

ใช้พร็อพเพอร์ตี้อาร์เรย์ intermediates ของเมธอด computeRoutes (REST) หรือเมธอด ComputeRoutes (gRPC) เพื่อกำหนดจุดอ้างอิงระหว่างกลางได้สูงสุด 25 จุด

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

ขาแต่ละข้างของเส้นทางจะแสดงด้วยวัตถุ RouteLeg (REST) หรือ RouteLeg (gRPC) ควบคุมช่อง RouteLeg ที่จะแสดงโดยใช้มาสก์ฟิลด์การตอบกลับ

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

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

ตัวอย่างนี้ใช้มาสก์ช่องการตอบกลับในส่วนหัว X-Goog-FieldMask ที่ระบุให้แสดงผลช่องต่อไปนี้ในคำตอบ

• routes.duration
• routes.distanceMeters
• routes.legs สอดคล้องกับออบเจ็กต์ RouteLeg ทั้งหมด

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE",
  "departureTime": "2022-10-15T15:01:23.045123456Z",
  "computeAlternativeRoutes": false,
  "routeModifiers": {
    "avoidTolls": false,
    "avoidHighways": false,
    "avoidFerries": false
  },
  "languageCode": "en-US",
  "units": "IMPERIAL"
}'
-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'

การตอบกลับจากการเรียกนี้ประกอบด้วยอาร์เรย์ legs แต่ละขั้นตอนของขาแต่ละขั้นจะแสดงด้วยออบเจ็กต์ RouteLegStep (REST) หรือ RouteLegStep (gRPC)

{
  "routes": [
    {
      "legs": [
        # First leg
        {
            "distanceMeters": 207,
            "duration": "89s",
            "staticDuration": "89s",
            "polyline": {
                "encodedPolyline": "ipkcFjgchVd@@@cF]@@oCK?"
            },
            "startLocation": {
                "latLng": {
                    "latitude": 37.4197318,
                    "longitude": -122.0826233
                }
            },
            "endLocation": {
                "latLng": {
                    "latitude": 37.419734,
                    "longitude": -122.08077919999998
                }
            },
            "steps": [            {
              "distanceMeters": 21,
              "staticDuration": "6s",
              "polyline": {
                "encodedPolyline": "ipkcFjgchVd@@"
              },
              "startLocation": {
                "latLng": {
                  "latitude": 37.4197318,
                  "longitude": -122.0826233
                }
              },
              "endLocation": {
                "latLng": {
                  "latitude": 37.41954,
                  "longitude": -122.08262750000002
                }
              }
            },
            ...
        },
        # Second leg
        {
            "distanceMeters": 598,
            "duration": "159s",
            "staticDuration": "159s",
            "polyline": {
                "encodedPolyline": "ipkcFz{bhVh@??{@xPBP?J}E{E?"
            },
            "startLocation": {
                "latLng": {
                    "latitude": 37.419734,
                    "longitude": -122.08077919999998
                }
            },
            "endLocation": {
                "latLng": {
                    "latitude": 37.417616599999995,
                    "longitude": -122.07938820000001
                }
            },
            "steps": [
                {
                  ...