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

ฟีเจอร์การค้นหาสิ่งที่อยู่ในเส้นทางมีให้บริการใน 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 ช่วง

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

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

    เส้นทางจะมีช่วงแยกกันสำหรับเส้นทางจากจุดอ้างอิงแต่ละจุดไปยังจุดอ้างอิงถัดไป ตัวอย่างเช่น หากเส้นทางมีจุดอ้างอิงต้นทาง 1 จุดและจุดอ้างอิงปลายทาง 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} $$
ถัดไป
ค้นหาบนเส้นทาง