ภาพรวมของการค้นหาตามเส้นทาง

ฟีเจอร์การค้นหาตามเส้นทางพร้อมใช้งานใน Places API (ใหม่) ต่อไปนี้

  • การค้นหาข้อความ (ใหม่) เท่านั้น: ค้นหาสถานที่ตามเส้นทางการเดินทางที่กำหนดไว้ล่วงหน้า
  • การค้นหาข้อความ (ใหม่) และการค้นหาในบริเวณใกล้เคียง (ใหม่): คำนวณสรุปเส้นทางจากสถานที่ต้นทางของเส้นทางที่ระบุไปยังสถานที่แต่ละแห่งในผลการค้นหา
  • การค้นหาข้อความ (ใหม่) เท่านั้น: คำนวณสรุปเส้นทางสำหรับสถานที่แต่ละแห่งตามเส้นทางการเดินทางที่กำหนดไว้ล่วงหน้า

ค้นหาสิ่งที่อยู่ในเส้นทาง

คุณใช้ Routes API เพื่อคำนวณเส้นทางการเดินทางระหว่างสถานที่ 2 แห่ง Routes API สามารถคำนวณเส้นทางสำหรับรถยนต์ จักรยาน ยานพาหนะ 2 ล้อ ระบบขนส่งสาธารณะ หรือการเดินเท้าได้

การค้นหาข้อความ (ใหม่) ช่วยให้คุณใช้เส้นทางที่คำนวณนี้เพื่อค้นหาตามเส้นทางได้ เมื่อใช้ตัวเลือกนี้ คุณจะส่งเส้นทางที่คำนวณไว้ล่วงหน้าจาก Routes API ไปยังคำขอการค้นหาข้อความ (ใหม่) จากนั้นการตอบกลับจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหาและอยู่ใกล้กับเส้นทางที่ระบุด้วย

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

ตัวอย่างเช่น ลองพิจารณาเส้นทางจากต้นทาง ซึ่งเรียกว่าจุดอ้างอิงใน Routes API ไปยังจุดหมายตามที่ Routes API คำนวณ

เส้นทางจากจุดอ้างอิงต้นทางไปยังจุดหมายพร้อมผลการค้นหา

เมื่อค้นหาตามเส้นทาง ระบบจะค้นหาเพื่อแสดงสถานที่ใกล้กับเส้นทางโดยใช้เวลาอ้อมน้อยที่สุดจากต้นทางไปยังปลายทาง ในตัวอย่างนี้ จุด A, B และ C คือสถานที่ที่แสดงผลจากการค้นหา

คำนวณสรุปการกำหนดเส้นทาง

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

ในรูปภาพต่อไปนี้ จุด A, B และ C คือสถานที่ที่แสดงในผลการค้นหา

จุด A, B และ C คือสถานที่ที่แสดงในผลการค้นหา

สำหรับการเดินทางไปยังสถานที่แต่ละแห่งในผลการค้นหา การตอบกลับจะมีระยะเวลาและระยะทางในการเดินทางจากต้นทางของเส้นทางไปยังสถานที่นั้น (หากมี)

โดยค่าเริ่มต้น ระบบจะคำนวณระยะเวลาและระยะทางในการเดินทางโดยใช้ตัวเลือก TRAFFIC_UNAWARE ใน Routes API คุณสามารถเลือกตั้งค่ากำหนดการกำหนดเส้นทางเพื่อพิจารณาสภาพการจราจรแบบเรียลไทม์ TRAFFIC_AWARE_OPTIMAL หรือสภาพการจราจรแบบเรียลไทม์ที่มีเวลาในการตอบสนองลดลง TRAFFIC_AWARE ในระหว่างการคำนวณได้

เกี่ยวกับเส้นทาง ช่วง และจุดอ้างอิง

เส้นทางประกอบด้วยองค์ประกอบหลายอย่างตามที่ Routes API คำนวณไว้ ดังนี้

องค์ประกอบที่ประกอบขึ้นเป็นเส้นทาง

เส้นทางประกอบด้วยองค์ประกอบต่อไปนี้

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

  • เส้นทาง: การเดินทางทั้งหมดจากจุดอ้างอิงต้นทาง ผ่านจุดอ้างอิงกลาง ไปยังจุดอ้างอิงปลายทาง เส้นทางประกอบด้วยช่วงอย่างน้อย 1 ช่วง

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

  • ช่วง: เส้นทางจากจุดอ้างอิงหนึ่งในเส้นทางไปยังจุดอ้างอิงถัดไปในเส้นทาง แต่ละช่วงประกอบด้วยขั้นตอนที่แยกกันอย่างน้อย 1 ขั้นตอน

    เส้นทางประกอบด้วยช่วงแยกต่างหากสำหรับเส้นทางจากจุดอ้างอิงแต่ละจุดไปยังจุดถัดไป ตัวอย่างเช่น หากเส้นทางมีจุดอ้างอิงต้นทางจุดเดียวและจุดอ้างอิงปลายทางจุดเดียว เส้นทางนั้นจะมีช่วงเดียว

    สำหรับจุดอ้างอิงเพิ่มเติมแต่ละจุดที่คุณเพิ่มลงในเส้นทางหลังจากต้นทางและปลายทาง ซึ่งเรียกว่าจุดอ้างอิงระดับกลาง API จะเพิ่มช่วงแยกต่างหาก

ดูข้อมูลเพิ่มเติมเกี่ยวกับเส้นทางและการคำนวณเส้นทางได้ที่ Routes API

คำนวณสรุปการกำหนดเส้นทางด้วยการค้นหาตามเส้นทาง

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

ตัวอย่างเช่น ลองพิจารณาเส้นทางต่อไปนี้จากต้นทางไปยังปลายทางตามที่คำนวณโดย Routes API ส่งเส้นทางนี้ไปยัง Text Search (New) API พร้อมกับเกณฑ์การค้นหา

เส้นทางจากจุดอ้างอิงต้นทางไปยังจุดหมายพร้อมการเปลี่ยนเส้นทางไปยังผลการค้นหา

ในตัวอย่างนี้ สถานที่ตั้ง A คือสถานที่ที่แสดงในผลการค้นหาจากการค้นหาข้อความ (ใหม่) สําหรับสถานที่แต่ละแห่งในการตอบกลับ การค้นหาจะรวมระยะเวลาและระยะทางที่ต้องใช้ในการอ้อมไปยังสถานที่นั้นเป็นการเดินทาง 2 ช่วง ดังนี้

  • ช่วงแรกประกอบด้วยระยะเวลาและระยะทางในการเดินทางจากจุดเริ่มต้นของเส้นทางไปยังสถานที่ ในตัวอย่างนี้คือจากต้นทางไปยังสถานที่ A
  • ส่วนที่ 2 ประกอบด้วยระยะเวลาและระยะทางในการเดินทางจากสถานที่ไปยังจุดหมายของเส้นทาง ในตัวอย่างนี้คือจาก A ไปยังปลายทาง

จากข้อมูลในคำตอบ คุณจะคำนวณระยะเวลาและระยะทางในการอ้อมได้ โดยที่

  • \(t_{OD}\) คือระยะเวลาการเดินทางจากต้นทางไปยังจุดหมาย \(s_{OD}\) คือระยะทางการเดินทางจากต้นทางไปยังจุดหมาย
  • \(t_{OA}\) คือระยะเวลาการเดินทางจากต้นทางไปยัง A \(s_{OA}\) คือระยะทางการเดินทางจากต้นทางไปยัง A
  • \(t_{AD}\) คือระยะเวลาการเดินทางจากจุด A ไปยังจุดหมาย \(s_{AD}\) คือระยะทางการเดินทางจากจุด A ไปยังจุดหมาย

ระยะเวลาการออกนอกเส้นทางคือความแตกต่างของระยะเวลาระหว่างการเดินทางเดิม (จากต้นทางไปยังจุดหมาย) กับการเดินทางใหม่ (จากต้นทางไปยังจุดหมายผ่าน A)

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

ระยะทางอ้อมคือความแตกต่างของระยะทางระหว่างการเดินทางเดิม (จากต้นทางไปยังจุดหมาย) กับการเดินทางใหม่ (จากต้นทางไปยังจุดหมายผ่าน A)

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$
ถัดไป
ค้นหาบนเส้นทาง