เริ่มต้นใช้งาน Places Insights

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

  • ฟังก์ชัน Places Count สามารถแสดงผลจำนวนใดก็ได้ รวมถึง 0 แต่จะบังคับใช้พื้นที่ค้นหาขั้นต่ำ 40.0 เมตรคูณ 40.0 เมตร (1,600 ตร.ม.) (40.0 เมตรคูณ 40.0 เมตร / 1,600 ตร.ม.) นอกจากนี้ ฟังก์ชันยังแสดงผลรหัสสถานที่ ซึ่งสามารถใช้เพื่อค้นหาข้อมูลเกี่ยวกับสถานที่แต่ละแห่ง และรองรับการวิเคราะห์จุดที่น่าสนใจย้อนหลังในสแนปชอตรายเดือนที่ผ่านมาโดยใช้ตัวกรองวันที่ (ไม่บังคับ)

  • การค้นหาชุดข้อมูลสถานที่จะแสดงผลจำนวนตั้งแต่ 5 ขึ้นไปเท่านั้น (ละเว้นจำนวนที่ต่ำตั้งแต่ 0-4 เพื่อรักษา Differential Privacy) แต่ไม่จำกัดขนาดของพื้นที่ค้นหา

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

เลือกฟังก์ชัน Places Count ที่เหมาะสมที่สุด

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

  • PLACES_COUNT_PER_H3: แสดงผลตาราง BigQuery ของจำนวนสถานที่ต่อเซลล์ H3 เราขอแนะนำให้ใช้ฟังก์ชันนี้สำหรับการวิเคราะห์ความหนาแน่นระดับภูมิภาคและการสร้างแผนที่ความหนาแน่นแบบ Choropleth
  • PLACES_COUNT_V2: แสดงผลตารางที่มีจำนวนสถานที่และรหัสสถานที่ตัวอย่าง ฟังก์ชันนี้ยอมรับพารามิเตอร์ตารางที่มีภูมิศาสตร์ที่คุณป้อน การส่งทั้งตารางโดยตรงช่วยให้เครื่องมือการดำเนินการของ BigQuery สามารถกระจายภาระงานและประมวลผลจุดตัดเชิงพื้นที่พร้อมกันได้ ซึ่งช่วยให้การประมวลผลแบบกลุ่มมีประสิทธิภาพสูงสำหรับการวิเคราะห์ขนาดใหญ่
  • PLACES_COUNT_PER_TYPE_V2: แสดงผลตารางจำนวนสถานที่และรหัสสถานที่ตัวอย่าง โดยจัดหมวดหมู่ตามประเภทสถานที่ เช่นเดียวกับ PLACES_COUNT_V2 การส่งข้อมูลภูมิศาสตร์เป็นพารามิเตอร์ตารางช่วยให้ BigQuery สามารถประมวลผลจุดตัดเชิงพื้นที่แบบขนานในชุดข้อมูลขนาดใหญ่ได้โดยตรง
  • PLACES_COUNT_CHANGE: แสดงผลตารางจำนวนสถานที่ รวมถึงรหัสสถานที่ที่เพิ่มและนำออกระหว่าง 2 เดือนที่ระบุ เช่นเดียวกับ PLACES_COUNT_V2 การส่งข้อมูลภูมิศาสตร์ที่ป้อนเป็นพารามิเตอร์ตารางช่วยให้ BigQuery สามารถประมวลผลจุดตัดเชิงพื้นที่แบบขนานในชุดข้อมูลขนาดใหญ่ได้โดยตรง

นอกจากจำนวนสถานที่แล้ว ฟังก์ชันเหล่านี้ยังแสดงผลรหัสสถานที่สูงสุด 250 รายการต่อองค์ประกอบของการตอบกลับด้วย

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

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

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

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

เช่น

PROJECT_NAME.places_insights___us.PLACES_COUNT_V2

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

กรองผลการค้นหาโดยใช้พารามิเตอร์ที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

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

ค้นหาสแนปชอตที่ผ่านมาด้วย snapshot_date

โดยค่าเริ่มต้น ฟังก์ชัน Places Count จะค้นหาภาพรวมข้อมูลล่าสุดที่มีอยู่ หากต้องการวิเคราะห์ข้อมูลสถานที่ที่มีอยู่ในช่วงเดือนที่ผ่านมา ให้เพิ่มพารามิเตอร์ snapshot_date ที่ไม่บังคับลงใน JSON_OBJECT

  • รูปแบบ: YYYY-MM (เช่น '2026-07')
  • ค่าเริ่มต้น: หากละเว้น ฟังก์ชันจะค้นหาภาพรวมล่าสุดโดยอัตโนมัติ

ตัวอย่างต่อไปนี้จะค้นหาจำนวนร้านอาหารรอบๆ พื้นที่ค้นหาของคุณตามที่บันทึกไว้ในสแนปชอตเดือนกรกฎาคม 2026

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'snapshot_date', '2026-07' -- Optional historical snapshot month
  )
);

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

ก่อนอื่น ให้ใช้ตารางภูมิศาสตร์อินพุตหรือเตรียมตารางที่มีภูมิศาสตร์ที่เลือกไว้ ดังนี้

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

จากนั้นเรียกใช้ PLACES_COUNT_V2 ด้วยตารางและออบเจ็กต์ JSON ที่มีตัวกรอง รัศมีการค้นหาจะรวมอยู่ในตัวกรอง JSON และจะใช้กับแต่ละจุดในตาราง my_search_areas

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

ตัวอย่าง: ค้นหาจำนวนร้านอาหารและสถานที่ตั้งของแบรนด์ด้วย PLACES_COUNT_V2

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

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'snapshot_date', '2026-07'
      )
);

การตอบกลับคือตาราง BigQuery ที่มี geo_id, ภูมิศาสตร์, จำนวน และตัวอย่างรหัสสถานที่

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

ตัวอย่างต่อไปนี้ใช้ฟังก์ชัน PLACES_COUNT_V2 เพื่อกรองตามรหัสแบรนด์ที่เฉพาะเจาะจง ในตัวอย่างนี้ เราจะกรองสถานที่ตั้งของ Starbucks โดยใช้รหัสแบรนด์ "1413758728321880760"

หากต้องการค้นหารหัสแบรนด์สำหรับแบรนด์ที่ต้องการกรอง ให้ค้นหาตาราง brands สำหรับชุดข้อมูลของคุณ (เช่น places_insights___us.brands) ดูข้อมูลเพิ่มเติมเกี่ยวกับชุดข้อมูลแบรนด์ได้ที่เขียนการค้นหาโดยใช้ข้อมูลแบรนด์

เช่น หากต้องการค้นหารหัสแบรนด์ของ "Starbucks" ให้ทำดังนี้

SELECT id, name
FROM `PROJECT_NAME.places_insights___us.brands`
WHERE name = "Starbucks"

หลังจากได้รับรหัสแบรนด์แล้ว คุณสามารถใช้รหัสดังกล่าวในตัวกรอง brand_ids ดังที่แสดงในคำค้นหาต่อไปนี้

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'brand_ids', ["1413758728321880760"]
      )
);

แสดงภาพเอาต์พุตการค้นหาด้วยเครื่องมือ Google Cloud

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

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

ข้อจำกัดและข้อกำหนดของฟังก์ชัน

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

  • ฟังก์ชันรองรับเฉพาะข้อมูลเชิงลึกของ COUNT เท่านั้น
  • พื้นที่ค้นหาต้องมีขนาดอย่างน้อย 40.0 เมตรคูณ 40.0 เมตร (1,600 ตร.ม.) (40.0 เมตรคูณ 40.0 เมตร/ 1,600 ตร.ม.)
  • ขีดจำกัดขนาดอินพุตพารามิเตอร์: ออบเจ็กต์ JSON ที่ส่งเป็นพารามิเตอร์ไปยังฟังก์ชันมีขนาดจำกัดอยู่ที่ 1 MB ผลกระทบของขีดจำกัดนี้ขึ้นอยู่กับเวอร์ชันของฟังก์ชัน ดังนี้
    • สำหรับฟังก์ชัน V2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2, PLACES_COUNT_CHANGE) ขีดจำกัดนี้จะมีผลกับออบเจ็กต์ JSON ของตัวกรองเท่านั้น เนื่องจากมีการระบุภูมิศาสตร์แยกกันโดยใช้พารามิเตอร์ตาราง ฟังก์ชันเหล่านี้จึงปรับขนาดเป็นภูมิศาสตร์อินพุตจำนวนมากขึ้นได้โดยไม่ถึงขีดจำกัดขนาด JSON
    • สำหรับ PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE และ PLACES_COUNT_PER_GEO ขีดจำกัดนี้จะมีผลกับออบเจ็กต์ JSON ทั้งหมด รวมถึงคำจำกัดความทางภูมิศาสตร์ทั้งหมด ซึ่งอาจจำกัดจำนวนภูมิศาสตร์ที่ประมวลผลได้ในการเรียกใช้ครั้งเดียว
  • ไม่รองรับการกรองตามรหัสสถานที่หรือคอมโพเนนต์ที่อยู่
  • คุณจะเข้าถึงฟังก์ชัน Places Count ได้เฉพาะในเมืองและประเทศที่คุณสมัครใช้บริการเท่านั้น ดูตั้งค่าข้อมูลเชิงลึกเกี่ยวกับสถานที่เพื่อเข้าถึงชุดข้อมูล
  • พารามิเตอร์ตัวกรอง (เช่น geography หรือ types) จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และต้องตรงกับชื่อพารามิเตอร์ทุกประการ ไม่เช่นนั้นการค้นหาจะล้มเหลว