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

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

ไม่รองรับจุดอ้างอิงระดับกลาง

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

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

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

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

ตัวอย่างต่อไปนี้ใช้พร็อพเพอร์ตี้อาร์เรย์ intermediates เพื่อเพิ่มการชี้ทางระดับกลาง 1 จุดไปยังเนื้อหาคำขอ 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": [
                {
                  ...