ข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองประเภท

ใน Places Aggregate API type filter จะช่วยให้คุณมุ่งเน้นการค้นหาได้โดยให้คุณเลือกประเภทสถานที่ที่ต้องการ รวมไว้หรือละเว้นจากคำตอบ คุณสามารถสร้างรายการประเภทที่ต้องการ และประเภทที่ไม่ต้องการได้ ทั้งสำหรับหมวดหมู่หลักของสถานที่และสำหรับ รายละเอียดอื่นๆ วิธีนี้จะช่วยให้คุณสร้างการค้นหาที่เฉพาะเจาะจงเพื่อค้นหาสถานที่ที่ต้องการได้อย่างแม่นยำ

มีประเภทสถานที่มากกว่า 200 ประเภท ดูรายการทั้งหมดที่ Places Aggregate API รองรับได้ที่ตาราง กในส่วนประเภท สถานที่สำหรับ Places API (ใหม่)

วิธีการทำงานของประเภทสถานที่

สถานที่อาจมีประเภทสถานที่หลายประเภท

• สถานที่หนึ่งๆ จะมีประเภทหลัก เดียวที่แสดงถึงฟังก์ชันหลัก ของสถานที่นั้น อย่างไรก็ตาม ในบางกรณี อาจไม่ได้ระบุประเภทหลักของสถานที่

• สถานที่หนึ่งๆ อาจมีประเภทรอง อย่างน้อย 1 ประเภท ประเภทรอง คือหมวดหมู่เพิ่มเติมที่ใช้กับสถานที่เพื่อระบุ ข้อมูลเสริมเกี่ยวกับลักษณะและบริการของสถานที่

เช่น สถานที่อาจระบุประเภทหลักเป็น restaurant แต่เนื่องจากยังทำหน้าที่เป็นบาร์และให้บริการอาหารด้วย จึงระบุประเภทสถานที่รองเป็น bar, food และ establishment ได้ด้วย

กรองตามประเภท

หากต้องการกรองสถานที่ตามประเภทหลัก ให้ใช้ includedPrimaryTypes และ excludedPrimaryTypes ในคำขอ ตัวกรองจะมีผลกับประเภทหลักของสถานที่เท่านั้น เช่น includedPrimaryTypesตัวกรองสำหรับ restaurant จะแสดงเฉพาะสถานที่ที่ทำหน้าที่เป็นร้านอาหารเป็นหลัก

หากต้องการกรองสถานที่ตามประเภทหลักและรอง ให้ใช้ includedTypes และ excludedTypes ในคำขอ ตัวกรองมีผลกับทั้ง 2 ประเภท เช่น includedTypesของbarจะแสดงสถานที่ที่มี barเป็นประเภทหลักหรือประเภทรอง

สำคัญ: เมื่อใช้ตัวกรองหลายรายการ คุณควรทำความเข้าใจการโต้ตอบระหว่างตัวกรอง โดยเฉพาะอย่างยิ่ง สถานที่จะได้รับการประเมินโดยใช้ตรรกะ OR ภายในตัวกรองเดียวกัน และตรรกะ AND ในตัวกรองต่างๆ

• ภายในตัวกรอง (ตรรกะ OR): เช่น includedTypes: restaurant, bar หมายความว่าสถานที่อาจเป็น restaurant หรือ bar
• ในตัวกรอง (ตรรกะ AND): เกณฑ์ตัวกรองที่ระบุทั้งหมดต้องเป็นไปตามพร้อมกัน ซึ่งหมายความว่าตัวกรองแต่ละรายการจะเพิ่มข้อจำกัดอีกชั้นหนึ่งให้กับคําค้นหา และเฉพาะสถานที่ที่ตรงตามเงื่อนไขทั้งหมดเท่านั้นที่จะรวมอยู่ในผลลัพธ์

เช่น หากคุณตั้งค่า includedTypes: restaurant, bar และ excludedTypes: hotel ก่อนอื่น ตัวกรอง includedTypes จะเลือกสถานที่ทั้งหมดที่จัดหมวดหมู่เป็น restaurant หรือ bar ประการที่ 2 ตัวกรอง excludedTypes จะนำสถานที่ที่เลือกซึ่งจัดอยู่ในหมวดหมู่ hotel ออก ดังนั้น คำค้นหาจะแสดงสถานที่ที่เป็นทั้งrestaurantหรือbar แต่จะแสดงเฉพาะในกรณีที่สถานที่นั้นไม่ได้จัดอยู่ในประเภทhotelในประเภทใดๆ (หลักหรือรอง)