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

ฟีเจอร์การค้นหาสิ่งที่อยู่ในเส้นทางมีให้บริการใน 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} $$
ถัดไป
ค้นหาบนเส้นทาง