ฟังก์ชัน PLACES_COUNT_PER_TYPE

ฟังก์ชัน PLACES_COUNT_PER_TYPE จะแสดงผลตารางจำนวนสำหรับสถานที่แต่ละแห่งที่มีประเภทที่ระบุไว้ในฟังก์ชัน ตัวอย่างเช่น หากคุณค้นหาประเภท doctor, hospital และ pharmacy การตอบกลับจะมีตารางที่มีแถวแยกต่างหากสำหรับแต่ละประเภท

หมายเหตุ: หากคุณระบุประเภททั้ง 3 แบบเดียวกันนี้ให้กับฟังก์ชัน PLACES_COUNT PLACES_COUNT จะแสดงผลค่าเดียวที่มีจำนวนรวมสำหรับทั้ง 3 ประเภท

เนื่องจากฟังก์ชัน PLACES_COUNT_PER_TYPE แสดงผลตาราง ให้เรียกใช้ฟังก์ชันโดยใช้ FROM

• พารามิเตอร์อินพุต

  • ต้องระบุ: geography พารามิเตอร์ตัวกรองที่ ระบุพื้นที่ค้นหา พารามิเตอร์ geography จะรับค่า ที่กำหนดโดย BigQuery GEOGRAPHY ประเภทข้อมูล ซึ่งรองรับจุด เส้น และรูปหลายเหลี่ยม

    ดูตัวอย่างการใช้ภูมิศาสตร์การค้นหาประเภทต่างๆ เช่น วิวพอร์ตและเส้น ได้ที่PLACES_COUNT ฟังก์ชัน

  • ต้องระบุ: types พารามิเตอร์ตัวกรองที่ ระบุประเภทสถานที่ที่จะค้นหา

  • ไม่บังคับ: พารามิเตอร์ตัวกรองเพิ่มเติมเพื่อปรับแต่ง การค้นหา

• ค่าที่ส่งคืน:

  • ตารางที่มี 1 แถวต่อค่า types ตารางประกอบด้วยคอลัมน์ type (STRING), count (INT64) และ place_ids (ARRAY<STRING>) โดย place_ids มีรหัสสถานที่ได้สูงสุด 250 รายการ สำหรับ type แต่ละรายการ

    หมายเหตุ: ตารางที่แสดงมี 1 แถวต่อค่า types แม้ว่าคุณจะใช้ primary_types เป็นตัวกรองได้ แต่ระบบจะจัดกลุ่มผลลัพธ์ตามtypes
    เท่านั้น

ตัวอย่าง: จำนวนการคืนสินค้าของร้านอาหาร คาเฟ่ และบาร์

ในตัวอย่างนี้ คุณค้นหาร้านอาหาร คาเฟ่ และบาร์ที่เปิดให้บริการทั้งหมดใน พื้นที่ค้นหาที่ระบุซึ่งกำหนดเป็นรูปหลายเหลี่ยมในนิวยอร์กซิตี้

พารามิเตอร์ types จะรับอาร์เรย์ของค่า STRING ที่ระบุประเภทสถานที่ ที่จะค้นหา ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ ประเภทสถานที่

ตัวอย่างนี้ยังใช้ฟังก์ชัน BigQuery ST_GEOGFROMTEXT เพื่อแสดงค่า GEOGRAPHY จากรูปหลายเหลี่ยมด้วย

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

ฟังก์ชันนี้จะแสดงผลตารางที่มี 3 แถว โดยมีแถวละ 1 ประเภท