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

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

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

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

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

ฟังก์ชัน Places Count และประเทศที่รองรับ

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

• 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 รายการต่อองค์ประกอบของการตอบกลับ นอกเหนือจากจำนวนสถานที่ ดูพารามิเตอร์ตัวกรองทั้งหมด

คุณใช้รหัสสถานที่กับสิ่งต่อไปนี้ได้

• Places API (ใหม่)
• Geocoding API
• Places UI Kit

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

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

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

เช่น

PROJECT_NAME.places_insights___us.PLACES_COUNT

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

กรองผลลัพธ์

ฟังก์ชัน Places Count รองรับตัวกรองหลายรายการเพื่อปรับแต่งการค้นหา พารามิเตอร์เหล่านี้ (เช่น 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;

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

ตัวอย่างนี้ใช้ฟังก์ชัน 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 และบุคคลที่สาม ซึ่งคุณใช้เพื่อวิเคราะห์ผลลัพธ์ของฟังก์ชันในข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่ได้

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

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

ฟังก์ชัน Places Count มีข้อจำกัดและข้อกำหนดต่อไปนี้

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

อ้างอิงฟังก์ชันจำนวนสถานที่ใน BigQuery

เมืองทั้งหมดในชุดข้อมูลตัวอย่างและชุดข้อมูลแบบเต็มของประเทศ รองรับฟังก์ชัน Places Count

คุณมีสิทธิ์เข้าถึงฟังก์ชัน Places Count ที่สอดคล้องกับชุดข้อมูลเมืองและ ประเทศที่คุณสมัครใช้บริการ ดูการเข้าถึงชุดข้อมูลได้ที่ตั้งค่าข้อมูลเชิงลึกเกี่ยวกับสถานที่

ตารางเหล่านี้แสดงรายชื่อเมือง ประเทศ และชื่อตารางที่เกี่ยวข้อง

ข้อมูลตัวอย่าง

ข้อมูลทั้งหมด