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

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

ใช้พร็อพเพอร์ตี้อาร์เรย์ 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": [
                {
                  ...