ฟังก์ชัน PLACES_COUNT_PER_TYPE

หมายเหตุ: ใช้ PLACES_COUNT_PER_TYPE_V2 เพื่อประสิทธิภาพที่ดีขึ้นอย่างเห็นได้ชัดและการประมวลผลแบบกลุ่มที่มีประสิทธิภาพ

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

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

เนื่องจากฟังก์ชัน PLACES_COUNT_PER_TYPE แสดงผลตาราง คุณจึงเรียกใช้ฟังก์ชันนี้ได้โดยใช้คําสั่ง FROM

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

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

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

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

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

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

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

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

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

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

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

ตัวอย่างนี้ยังใช้ฟังก์ชัน ST_GEOGFROMTEXT ของ BigQuery เพื่อแสดงผลค่า 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 แถวต่อประเภท ดังนี้

ตัวอย่าง: แสดงผลจำนวนต่อประเภทที่กรองตามแบรนด์

ตัวอย่างต่อไปนี้ใช้ตัวกรอง brand_ids เพื่อดึงข้อมูลจำนวนประเภทสำหรับ แบรนด์ที่เฉพาะเจาะจง เช่น Starbucks ที่มีรหัส "1413758728321880760"

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', ["cafe", "restaurant"],
      'geography', geo,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ['OPERATIONAL']
      )
);