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

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

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

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

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

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

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

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

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

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

คำนวณข้อมูลสรุปเส้นทาง

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

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

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

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

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

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

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

คอมโพเนนต์ที่ประกอบกันเป็นเส้นทาง

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

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

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

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

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

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

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

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

คำนวณข้อมูลสรุปเส้นทางด้วยการค้นหาสิ่งที่อยู่ในเส้นทาง

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

ตัวอย่างเช่น ลองพิจารณาเส้นทางต่อไปนี้จากต้นทางไปยังปลายทางตามที่ 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} $$