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

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

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

ชื่อตัวกรอง คำอธิบาย ประเภท ค่าที่รองรับ
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_type

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

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

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

 ARRAY<STRING>

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

ตัวอย่าง

["restaurant", "cafe", "bar"]
brand_ids

สำหรับ PLACES_COUNT_PER_H3 PLACES_COUNT_V2 และ PLACES_COUNT_PER_TYPE_V2 เท่านั้น

ระบุรหัสแบรนด์ที่จะพิจารณา

สถานที่แต่ละแห่งสามารถเชื่อมโยงกับรหัสแบรนด์ได้ หากไม่ได้ระบุรหัสแบรนด์ ระบบจะพิจารณาทุกแบรนด์ (และสถานที่ที่ไม่มีแบรนด์) ในผลลัพธ์

หมายเหตุ: ระบบรองรับข้อมูลแบรนด์ในบางประเทศเท่านั้น ปัจจุบันคือสหรัฐอเมริกา (US), แคนาดา (CA), สหราชอาณาจักร (GB) และออสเตรเลีย (AU)

 ARRAY<STRING>

อาร์เรย์ของรหัสแบรนด์ ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลแบรนด์ได้ที่ เขียนคําค้นหาโดยใช้ข้อมูลแบรนด์

ตัวอย่าง

["brand_001", "brand_002"]
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