ค้นหาชุดข้อมูลโดยใช้ฟังก์ชันการนับสถานที่

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

  • การค้นหาชุดข้อมูลสถานที่จะแสดงได้เฉพาะจำนวน 5 ขึ้นไป แต่ไม่มีข้อจำกัดเกี่ยวกับขนาดของพื้นที่ค้นหา
  • ฟังก์ชันการนับสถานที่สามารถแสดงผลการนับใดก็ได้ รวมถึง 0 แต่จะบังคับใช้พื้นที่ค้นหาขั้นต่ำ 40.0 x 40.0 เมตร (1600 ม.2) ฟังก์ชันยังแสดงผล Place ID ได้ด้วย ซึ่งใช้เพื่อ ค้นหาข้อมูลเกี่ยวกับสถานที่แต่ละแห่งได้

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

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

ฟังก์ชันและประเทศที่รองรับการนับสถานที่

ข้อมูลเชิงลึกเกี่ยวกับสถานที่รองรับฟังก์ชันต่อไปนี้

  • PLACES_COUNT: แสดงผลแถวเดียวที่มีจำนวนสถานที่
  • PLACES_COUNT_PER_TYPE: แสดงตาราง BigQuery ของจำนวนสถานที่ต่อประเภทสถานที่
  • PLACES_COUNT_PER_GEO: แสดงตาราง BigQuery ของ จำนวนสถานที่ต่อภูมิศาสตร์
  • PLACES_COUNT_PER_H3: แสดงตาราง BigQuery ที่มี จำนวนสถานที่ต่อเซลล์ H3

นอกจากจำนวนสถานที่แล้ว ฟังก์ชัน PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO และ PLACES_COUNT_PER_H3 ยังแสดงรหัสสถานที่ได้สูงสุด 250 รายการต่อองค์ประกอบของการตอบกลับด้วย ดูพารามิเตอร์ตัวกรองทั้งหมด

รหัสสถานที่ใช้ได้กับ

เขียนการค้นหาด้วยฟังก์ชัน

ใช้รูปแบบต่อไปนี้เพื่อเรียกใช้ฟังก์ชัน [project name (optional)].[table name].[function name]

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

เช่น

PROJECT_NAME.places_insights___us.PLACES_COUNT

ใช้ JSON_OBJECT เพื่อส่งอาร์กิวเมนต์ไปยังฟังก์ชัน

กรองผลลัพธ์

ฟังก์ชันการนับสถานที่รองรับตัวกรองมากมายเพื่อปรับแต่งการค้นหา พารามิเตอร์เหล่านี้ (เช่น price_level หรือ types) จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และต้องตรงกับชื่อพารามิเตอร์ทุกประการ ดูรายการตัวเลือกทั้งหมดได้ที่ข้อมูลอ้างอิงพารามิเตอร์ตัวกรอง

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

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

ตัวอย่างฟังก์ชันการนับสถานที่

ตัวอย่างต่อไปนี้ใช้ฟังก์ชัน PLACES_COUNT เพื่อแสดงจำนวนร้านอาหารที่เปิดให้บริการภายในรัศมี 1,000 เมตรจากตึกเอ็มไพร์สเตตในนครนิวยอร์ก

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

การตอบกลับจะมีจำนวนเดียว ดังนี้

ผลลัพธ์สำหรับฟังก์ชัน Place Count ในนิวยอร์กซิตี้

ตัวอย่างนี้ใช้ฟังก์ชัน BigQuery ST_GEOGPOINT เพื่อแสดงค่า GEOGRAPHY จากจุด แล้วส่งค่านั้นไปยังพารามิเตอร์ geography นอกจากนี้ ยังส่งรัศมีการค้นหารอบจุดและ ประเภทสถานที่ "restaurant" ที่จะค้นหาด้วย

ตัวอย่างจำนวนสถานที่ต่อประเภท ภูมิศาสตร์ หรือ H3

นอกจากจำนวนสถานที่แล้ว ฟังก์ชัน PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO และ PLACES_COUNT_PER_H3 ยังแสดงรหัสสถานที่ได้สูงสุด 250 รายการสำหรับสถานที่ที่รวมอยู่ในคำตอบด้วย

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

การเรียกฟังก์ชันต่อไปนี้จะแสดงผลจำนวนสถานที่ที่มีประเภทต่อไปนี้ restaurant, cafe และ bar

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

ฟังก์ชันนี้จะแสดงตารางที่มี 3 คอลัมน์ ได้แก่ type, count และ sample_place_ids count คอลัมน์แสดงจำนวนสถานที่สำหรับแต่ละ type และคอลัมน์ sample_place_ids แสดงรหัสสถานที่ได้สูงสุด 250 รายการสำหรับแต่ละ type

ผลลัพธ์สำหรับฟังก์ชันประเภทการนับสถานที่ในนิวยอร์กซิตี้

แสดงภาพผลลัพธ์

เครื่องมือวิเคราะห์และBusiness Intelligenceมีความสำคัญอย่างยิ่งต่อการช่วยให้คุณค้นพบข้อมูลเชิงลึกจากข้อมูล BigQuery BigQuery รองรับเครื่องมือสร้างภาพข้อมูลหลายรายการของ Google และบุคคลที่สาม ซึ่งคุณใช้เพื่อวิเคราะห์ผลลัพธ์ของฟังก์ชันในข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่ได้

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

ข้อจำกัดและข้อกำหนด

ฟังก์ชันการนับสถานที่ตั้งมีข้อจำกัดและข้อกำหนดต่อไปนี้

  • รองรับเฉพาะข้อมูลเชิงลึก COUNT เท่านั้น
  • ต้องมีพื้นที่ค้นหาขั้นต่ำ 40.0 x 40.0 เมตร (1600 ม.2)
  • ขนาดอินพุตพารามิเตอร์จำนวนฟังก์ชันของสถานที่จำกัดไว้ที่ 1 MB
  • ไม่รองรับการกรองตามรหัสสถานที่ แบรนด์ ตัวเลือกการชาร์จ EV หรือคอมโพเนนต์ที่อยู่
  • คุณจะเข้าถึงฟังก์ชันการนับสถานที่ได้เฉพาะเมืองและประเทศที่คุณติดตามเท่านั้น ดูรายละเอียดการเข้าถึงชุดข้อมูลได้ที่ตั้งค่าข้อมูลเชิงลึกเกี่ยวกับสถานที่
  • พารามิเตอร์ตัวกรอง (เช่น geography หรือ types) จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และต้องตรงกับชื่อพารามิเตอร์ทุกประการ ไม่เช่นนั้นการค้นหาจะล้มเหลว