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

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

  • ขับรถ
  • มอเตอร์ไซค์
  • ปั่นจักรยาน
  • เดินเท้า

เหตุใดจึงควรใช้การเพิ่มประสิทธิภาพจุดอ้างอิง

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

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

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

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

รับจุดอ้างอิงที่เรียงลำดับใหม่

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

หมายเหตุ: ช่อง optimizedIntermediateWaypointIndex จะแสดงผลแบบ 0

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

ตัวอย่างต่อไปนี้คือการระบุเส้นทางที่อยู่ใกล้สแตนฟอร์ด วิทยาเขตของมหาวิทยาลัย ได้มีการระบุจุดอ้างอิงของเส้นทางตามลำดับใน อีกครั้ง คำขอมีต้นทางและปลายทาง โดยมีตัวกลาง 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 ภายในออบเจ็กต์เส้นทางใน เนื้อหาการตอบกลับ ไฟล์ที่เข้ารหัส เส้นประกอบ จะเหมือนกับใน 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 วินาที หากยังคงได้รับข้อผิดพลาดการหมดเวลา คุณสามารถเพิ่มวินาทีอีกได้ แล้วลองอีกครั้ง

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

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

  • คุณสามารถระบุจุดอ้างอิงกลางใน เส้นทาง:

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

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

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

  • หากคำขอของคุณมีจุดอ้างอิงระหว่าง 25 จุดขึ้นไป จะต้องมี ปฏิบัติตามเงื่อนไขต่อไปนี้

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

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

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