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

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

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

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

เราขอแนะนำให้เริ่มต้นด้วย ฟังก์ชัน 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

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

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

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

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

  • ฟังก์ชันรองรับข้อมูลเชิงลึก COUNT เท่านั้น
  • ต้องมีพื้นที่ค้นหาขั้นต่ำ 40.0 เมตร x 40.0 เมตร (1,600 ตร.ม.) (40.0 เมตร x 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) คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และต้องตรงกับชื่อพารามิเตอร์ทุกประการ มิเช่นนั้นการค้นหาจะล้มเหลว