ภาพรวมของการค้นหาสิ่งที่อยู่ในเส้นทาง

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

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

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

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

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

การค้นหาสิ่งที่อยู่ในเส้นทางจะคล้ายกับการใช้ตัวเลือกคำขอ 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} $$