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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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