เพิ่มประสิทธิภาพจุดอ้างอิงของเส้นทาง

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

  • ขับรถ
  • ยานพาหนะ 2 ล้อที่ขับเคลื่อนด้วยเครื่องยนต์
  • ปั่นจักรยาน
  • เดินเท้า

เหตุผลที่ควรใช้การเพิ่มประสิทธิภาพจุดแวะพัก

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

วิธีการทำงาน

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

หมายเหตุ: การคำนวณการเพิ่มประสิทธิภาพจุดแวะพักจะอิงตามเวลาเดินทางเป็นหลัก แต่ฟีเจอร์นี้ยังพิจารณาปัจจัยอื่นๆ ด้วย เช่น ระยะทางและจำนวนการเลี้ยว

ดูจุดแวะพักที่จัดเรียงใหม่

หากต้องการดูเส้นทางที่มีจุดแวะพักที่จัดเรียงใหม่ ให้ตั้งค่าช่องบูลีน optimizeWaypointOrder เป็น true ในเนื้อหาของคำขอไปที่ ComputeRoutes และใส่ฟิลด์ optimizedIntermediateWaypointIndex ในมาสก์ฟิลด์ด้วย เนื้อหาการตอบกลับจะมีลําดับจุดแวะพักที่เพิ่มประสิทธิภาพแล้วในช่อง optimizedIntermediateWaypointIndex

หมายเหตุ: ฟิลด์ optimizedIntermediateWaypointIndex จะแสดงผลค่าแบบนับจากศูนย์

ตัวอย่างคำขอ

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

POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.418956,
        "longitude": -122.160815
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.4176423,
          "longitude":-122.1102246
        }
      }
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.407689,
          "longitude": -122.1360597
        }
      }
    }
  ],
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.4032137,
        "longitude": -122.0349119
      }
    }
  },
  "travelMode": "DRIVE",
  "optimizeWaypointOrder": true,
  "routingPreference": "TRAFFIC_AWARE"}

ตัวอย่างการตอบกลับ

คุณดูดัชนีจุดแวะพักกลางที่จัดเรียงใหม่ได้ในช่อง optimizedIntermediateWaypointIndex ภายในออบเจ็กต์เส้นทางในเนื้อหาการตอบกลับ Polyline ที่เข้ารหัสจะเหมือนกับใน Directions API และ ComputeRoutes

routes {
  distance_meters: 17647
  duration {
    seconds: 1866
  }
  polyline {
    encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
  }
  optimizedIntermediateWaypointIndex: 1
  optimizedIntermediateWaypointIndex: 0
}

ในตัวอย่างนี้ โปรดสังเกตว่าการเพิ่มประสิทธิภาพจุดแวะพักจะกลับลําดับเดิม

คำขอที่มีจุดแวะพักที่เพิ่มประสิทธิภาพจะใช้เวลาประมวลผลนานกว่าคำขอเส้นทางที่เรียบง่าย ดังนั้น เราขอแนะนําให้คุณตั้งค่าการหมดเวลาในการเรียกใช้เมธอดให้สูงขึ้นโดยกําหนดค่าส่วนหัวคําขอ X-Server-Timeout เป็นอย่างน้อย 10 วินาที หากยังได้รับข้อผิดพลาดเกี่ยวกับเวลาหมด ให้รออีก 1 วินาทีแล้วลองอีกครั้ง

ข้อจำกัดการใช้งาน

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

  • คุณระบุจุดแวะพักระหว่างทางได้สูงสุดตามขีดจำกัดการใช้งานในเส้นทาง ดังนี้

    • จุดแวะพักได้สูงสุด 98 จุดโดยใช้เฉพาะพิกัดละติจูดและลองจิจูด
    • จุดแวะพักได้สูงสุด 25 จุดหากระบุจุดแวะพักโดยใช้รหัสสถานที่

  • จุดแวะพักทั้งหมดต้องเป็นประเภทจุดแวะพัก จุดแวะพักต้องไม่มีประเภทเป็นผ่าน

  • คุณต้องเพิ่ม routes.optimizedIntermediateWaypointIndex ลงในช่องหน้ากาก

  • หากคำขอของคุณมีจุดแวะพักกลางทาง 25 จุดขึ้นไป คำขอดังกล่าวต้องเป็นไปตามเงื่อนไขต่อไปนี้ด้วย

    • ระยะทางรวมในแนวเส้นตรงระหว่างจุดแวะพักทั้งหมดต้องน้อยกว่า 1,000 กิโลเมตร โดยระยะทางนี้รวมทั้งต้นทางและปลายทาง

    • โหมดการเดินทางต้องเป็น DRIVE

เนื้อหาที่แนะนำ