พารามิเตอร์ตัวกรอง

คุณสามารถใช้ตัวกรองกับฟังก์ชัน การนับสถานที่ โดยใช้พารามิเตอร์ที่อธิบายไว้ในตารางด้านล่าง โปรดทราบว่าพารามิเตอร์ที่จำเป็นจะแตกต่างกันไปในแต่ละฟังก์ชัน ดังนี้

ชื่อตัวกรองและค่าของตัวกรองเป็นแบบพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ คุณต้องระบุชื่อและค่าให้ตรงกับที่ปรากฏในตาราง ไม่เช่นนั้นคําค้นหาจะแสดงข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ที่ไม่ถูกต้อง

ชื่อตัวกรอง คำอธิบาย ประเภท ค่าที่รองรับ
geography

สำหรับ PLACES_COUNT, PLACES_COUNT_PER_TYPE และ PLACES_COUNT_PER_H3

ระบุพื้นที่ที่จะค้นหา ระบบรองรับ GEOGRAPHY ทุกประเภท เช่น Point, LineString, และ Polygon

คุณสามารถใช้พารามิเตอร์ geography ร่วมกับ geography_radius เพื่อเพิ่มบัฟเฟอร์ให้กับพื้นที่ค้นหา

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

 GEOGRAPHY GEOGRAPHY ทุกประเภท
geographies

สำหรับ PLACES_COUNT_PER_GEO เท่านั้น

ระบุรายการพื้นที่ที่จะค้นหา ระบบรองรับ GEOGRAPHY ทุกประเภท เช่น Point, LineString, และ Polygon

คุณสามารถใช้พารามิเตอร์ geographies ร่วมกับ geography_radius เพื่อเพิ่มบัฟเฟอร์ให้กับพื้นที่ค้นหา ระบบจะเพิ่มบัฟเฟอร์ให้กับภูมิศาสตร์ทั้งหมดที่ระบุ

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

 ARRAY<GEOGRAPHY> GEOGRAPHY ทุกประเภท
geography_radius

เพิ่มรัศมีหรือบัฟเฟอร์เป็นเมตรให้กับภูมิศาสตร์ที่ระบุ ค่าเริ่มต้นคือ 0

ค่าที่ระบุต้องกำหนดพื้นที่ค้นหาขั้นต่ำ 40.0 เมตร x 40.0 เมตร (1600 ตร.ม.) เช่น สำหรับภูมิศาสตร์ Point รัศมีขั้นต่ำจึงเป็น 23 เมตร

 INT64 ค่าต่ำสุดคือ 0
h3_resolution

สำหรับ PLACES_COUNT_PER_H3 เท่านั้น

ความละเอียด H3 ที่ใช้ในการรวบรวมจำนวนสถานที่ลงในเซลล์ H3

 INT64 ระหว่าง 0 ถึง 11
types

ระบุประเภทสถานที่ที่จะพิจารณา

สถานที่แต่ละแห่งมีชุดประเภทสถานที่ เช่น "restaurant" และ "cafe" หากไม่ได้ระบุประเภทไว้ ระบบจะพิจารณาสถานที่ทุกประเภทในผลลัพธ์

 ARRAY<STRING>

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ ประเภทสถานที่

ตัวอย่าง

["restaurant", "cafe", "bar"]
primary_types

ระบุประเภทหลักที่จะพิจารณา

สถานที่หนึ่งๆ จะมีประเภทหลักได้เพียงประเภทเดียว ซึ่งเป็นประเภทที่อธิบายสถานที่ได้ดีที่สุด

หากไม่ได้ระบุประเภทหลักไว้ ระบบจะพิจารณาประเภทหลักของสถานที่ทุกประเภทในผลลัพธ์

 ARRAY<STRING>

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ ประเภทสถานที่

ตัวอย่าง

["restaurant", "cafe", "bar"]
min_rating ระบุคะแนนขั้นต่ำของสถานที่ที่จะพิจารณา

คะแนนสถานที่อิงตามรีวิวของผู้ใช้เกี่ยวกับสถานที่ดังกล่าวและมีช่วงระหว่าง 1.0 ถึง 5.0

หากคุณระบุคะแนนนอกช่วงนี้ ฟังก์ชันจะแสดงข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ที่ไม่ถูกต้อง

 FLOAT ระหว่าง 1.0 ถึง 5.0
max_rating

ระบุคะแนนสูงสุดของสถานที่ที่จะพิจารณา

คะแนนสถานที่อิงตามรีวิวของผู้ใช้เกี่ยวกับสถานที่ดังกล่าวและมีช่วงระหว่าง 1.0 ถึง 5.0

หากคุณระบุคะแนนนอกช่วงนี้ ฟังก์ชันจะแสดงข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ที่ไม่ถูกต้อง

 FLOAT ระหว่าง 1.0 ถึง 5.0
min_user_rating_count

ระบุจำนวนการให้คะแนนของผู้ใช้ขั้นต่ำที่จะพิจารณา

จำนวนการให้คะแนนของผู้ใช้คือจำนวนรีวิวทั้งหมดที่สถานที่ได้รับ

ค่าต่ำสุดคือ 0 หากคุณระบุค่าต่ำกว่า 0 ฟังก์ชันจะแสดงข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ที่ไม่ถูกต้อง

 INT64 ค่าต่ำสุดคือ 0
max_user_rating_count

ระบุจำนวนการให้คะแนนของผู้ใช้สูงสุดที่จะพิจารณา

จำนวนการให้คะแนนของผู้ใช้คือจำนวนรีวิวทั้งหมดที่สถานที่ได้รับ

ค่าต่ำสุดคือ 0 หากคุณระบุค่าต่ำกว่า 0 ฟังก์ชันจะแสดงข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ที่ไม่ถูกต้อง

 INT64 ค่าต่ำสุดคือ 0
price_level

ระบุระดับราคาที่จะพิจารณา

คุณสามารถระบุระดับราคาได้หลายระดับ

 ARRAY<STRING>

ค่าที่รองรับมีดังนี้

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

ตัวอย่าง

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status ระบุสถานะธุรกิจที่จะพิจารณา คุณสามารถระบุสถานะธุรกิจได้หลายสถานะ ARRAY<STRING>

ค่าที่รองรับมีดังนี้

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

ตัวอย่าง

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout พิจารณาสถานที่ที่มีบริการสั่งกลับบ้าน BOOLEAN TRUE, FALSE
delivery พิจารณาสถานที่ที่มีบริการจัดส่ง BOOLEAN TRUE, FALSE
dine_in พิจารณาสถานที่ที่มีบริการนั่งรับประทานอาหารในร้าน BOOLEAN TRUE, FALSE
curbside_pickup พิจารณาสถานที่ที่มีบริการรับสินค้าโดยไม่ต้องลงจากรถ BOOLEAN TRUE, FALSE
reservable พิจารณาสถานที่ที่จองได้ BOOLEAN TRUE, FALSE
outdoor_seating พิจารณาสถานที่ที่มีที่นั่งกลางแจ้ง BOOLEAN TRUE, FALSE
live_music พิจารณาสถานที่ที่มีดนตรีสด BOOLEAN TRUE, FALSE
allows_dogs พิจารณาสถานที่ที่อนุญาตให้นำสุนัขเข้าได้ BOOLEAN TRUE, FALSE
restroom พิจารณาสถานที่ที่มีห้องน้ำ BOOLEAN TRUE, FALSE
serves_breakfast พิจารณาสถานที่ที่เสิร์ฟอาหารเช้า BOOLEAN TRUE, FALSE
serves_lunch พิจารณาสถานที่ที่เสิร์ฟอาหารกลางวัน BOOLEAN TRUE, FALSE
serves_dinner พิจารณาสถานที่ที่เสิร์ฟอาหารเย็น BOOLEAN TRUE, FALSE
serves_beer พิจารณาสถานที่ที่เสิร์ฟเบียร์ BOOLEAN TRUE, FALSE
serves_wine พิจารณาสถานที่ที่เสิร์ฟไวน์ BOOLEAN TRUE, FALSE
serves_brunch พิจารณาสถานที่ที่เสิร์ฟอาหารมื้อสาย BOOLEAN TRUE, FALSE
serves_vegetarian_food พิจารณาสถานที่ที่เสิร์ฟอาหารมังสวิรัติ BOOLEAN TRUE, FALSE
serves_cocktails พิจารณาสถานที่ที่เสิร์ฟค็อกเทล BOOLEAN TRUE, FALSE
serves_dessert พิจารณาสถานที่ที่เสิร์ฟของหวาน BOOLEAN TRUE, FALSE
serves_coffee พิจารณาสถานที่ที่เสิร์ฟกาแฟ BOOLEAN TRUE, FALSE
menu_for_children พิจารณาสถานที่ที่มีเมนูสำหรับเด็ก BOOLEAN TRUE, FALSE
good_for_children พิจารณาสถานที่ที่เหมาะสำหรับเด็ก BOOLEAN TRUE, FALSE
good_for_groups พิจารณาสถานที่ที่เหมาะสำหรับกลุ่ม BOOLEAN TRUE, FALSE
good_for_watching_sports พิจารณาสถานที่ที่เหมาะสำหรับการดูกีฬา BOOLEAN TRUE, FALSE
accepts_credit_cards พิจารณาสถานที่ที่รับบัตรเครดิต BOOLEAN TRUE, FALSE
accepts_debit_cards พิจารณาสถานที่ที่รับบัตรเดบิต BOOLEAN TRUE, FALSE
accepts_cash_only พิจารณาสถานที่ที่รับเฉพาะเงินสด BOOLEAN TRUE, FALSE
accepts_nfc พิจารณาสถานที่ที่รับการชำระเงินผ่าน NFC BOOLEAN TRUE, FALSE
free_parking_lot พิจารณาสถานที่ที่มีที่จอดรถฟรี BOOLEAN TRUE, FALSE
paid_parking_lot พิจารณาสถานที่ที่มีที่จอดรถแบบเสียค่าใช้จ่าย BOOLEAN TRUE, FALSE
free_street_parking พิจารณาสถานที่ที่มีที่จอดรถริมถนนฟรี BOOLEAN TRUE, FALSE
paid_street_parking พิจารณาสถานที่ที่มีที่จอดรถริมถนนแบบเสียค่าใช้จ่าย BOOLEAN TRUE, FALSE
valet_parking พิจารณาสถานที่ที่มีบริการรับจอดรถ BOOLEAN TRUE, FALSE
free_garage_parking พิจารณาสถานที่ที่มีโรงจอดรถฟรี BOOLEAN TRUE, FALSE
paid_garage_parking พิจารณาสถานที่ที่มีโรงจอดรถแบบเสียค่าใช้จ่าย BOOLEAN TRUE, FALSE
wheelchair_accessible_parking พิจารณาสถานที่ที่มีที่จอดรถที่รองรับเก้าอี้รถเข็น BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance พิจารณาสถานที่ที่มีทางเข้าสำหรับเก้าอี้รถเข็น BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom พิจารณาสถานที่ที่มีห้องน้ำสำหรับเก้าอี้รถเข็น BOOLEAN TRUE, FALSE
wheelchair_accessible_seating พิจารณาสถานที่ที่มีที่นั่งสำหรับเก้าอี้รถเข็น BOOLEAN TRUE, FALSE