ค้นหาการเปลี่ยนแปลง POI ระหว่างเดือน (PLACES_COUNT_CHANGE)

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

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

ไวยากรณ์

SELECT *
FROM
  `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_CHANGE`(
    TABLE input_geographies,
    filters
  );

พารามิเตอร์

  • PROJECT_NAME: ชื่อโปรเจ็กต์ Google Cloud
  • LINKED_DATASET_NAME: ชื่อชุดข้อมูล BigQuery ที่มีฟังก์ชันข้อมูลเชิงลึกเกี่ยวกับสถานที่ (เช่น places_insights___us)
  • input_geographies: ตาราง BigQuery ที่มีพื้นที่ทางภูมิศาสตร์ที่จะวิเคราะห์ ตารางนี้ต้อง มีคอลัมน์ต่อไปนี้
    • geo_id (STRING): ตัวระบุที่ไม่ซ้ำกันสำหรับพื้นที่ทางภูมิศาสตร์แต่ละแห่ง
    • geo (GEOGRAPHY): ออบเจ็กต์ GEOGRAPHY ของ BigQuery ที่แสดงพื้นที่ ซึ่งอาจเป็นจุด รูปหลายเหลี่ยม หรือพื้นที่ทางภูมิศาสตร์ประเภทอื่นๆ
  • filters (JSON): ออบเจ็กต์ JSON ที่มีคู่คีย์-ค่าสำหรับกรองสถานที่ ดู พารามิเตอร์ ตัวกรอง โดยต้องมีตัวกรองต่อไปนี้
    • month1 (STRING): เดือนแรกที่จะค้นหาสถานที่
    • month2 (STRING): เดือนที่สองที่จะค้นหาสถานที่

สคีมาของตารางเอาต์พุต

ฟังก์ชัน PLACES_COUNT_CHANGE จะแสดงตารางที่มีคอลัมน์ต่อไปนี้

ชื่อคอลัมน์ ประเภทข้อมูล คำอธิบาย
geo_id STRING รหัสจากพื้นที่ทางภูมิศาสตร์ที่ป้อน
start_count INT64 จำนวนสถานที่จากเดือนแรก
end_count INT64 จำนวนสถานที่จากเดือนที่สอง
net_change INT64 ความแตกต่างระหว่าง end_count กับ start_count (end_count - start_count)
percentage_change FLOAT64 เปอร์เซ็นต์การเปลี่ยนแปลงจากเดือน 1 เป็นเดือน 2
compound_monthly_growth_rate FLOAT64 อัตราการเติบโตรายเดือนแบบทบต้นจากเดือน 1 เป็นเดือน 2
added_count INT64 จำนวนรหัสสถานที่ตัวอย่างใน sample_added_place_ids
removed_count INT64 จำนวนรหัสสถานที่ตัวอย่างใน sample_removed_place_ids
sample_added_place_ids ARRAY<STRING> รายการรหัสสถานที่ตัวอย่างที่อยู่ในเดือน 2 แต่ไม่อยู่ในเดือน 1
sample_removed_place_ids ARRAY<STRING> รายการรหัสสถานที่ตัวอย่างที่อยู่ในเดือน 1 แต่ไม่อยู่ในเดือน 2

ระบบจะจัดเรียงผลลัพธ์ตาม percentage_change และ start_count จากมากไปน้อย

วิธีการทำงาน

ฟังก์ชันจะประมวลผลแต่ละแถวในตาราง input_geographies สำหรับ geo ออบเจ็กต์แต่ละรายการ ฟังก์ชันจะนับจำนวนสถานที่ที่อยู่ในพื้นที่ทางภูมิศาสตร์ (หรือภายใน geography_radius หาก geo เป็นจุดและมีการระบุรัศมีใน filters) ใน 2 เดือนที่ระบุใน month1 และ month2 ใน filters โดยใช้สถานที่เหล่านั้น ฟังก์ชันจะคำนวณสถิติที่เป็นประโยชน์อื่นๆ เช่น เปอร์เซ็นต์การเปลี่ยนแปลงและอัตราการเติบโตรายเดือนแบบทบต้นจากเดือนแรกถึงเดือนที่สอง

การนับจะรวมเฉพาะสถานที่ที่ตรงกับเงื่อนไขทั้งหมดที่กำหนดไว้ในออบเจ็กต์ JSON filters

ตัวอย่าง: คำนวณการเปลี่ยนแปลงในจำนวนจุดที่น่าสนใจระหว่าง 2 เดือน

ตัวอย่างนี้แสดงวิธีค้นหาการเปลี่ยนแปลงในจำนวนจุดที่น่าสนใจระหว่าง 2 เดือนที่เฉพาะเจาะจงโดยใช้พารามิเตอร์ month1 และ month2 โดยมีรัศมี 5, 000 จากจุดตำแหน่งทางภูมิศาสตร์ที่กำหนด

WITH my_locations AS (
  SELECT
    'loc_1' AS geo_id,
    ST_GEOGFROMTEXT('POINT(-122.4194 37.7749)') AS geo
  -- Add more target locations as needed...
)

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_CHANGE`(
  TABLE my_locations,
  JSON_OBJECT(
    'geography_radius', 5000,
    'month1', '2026-01', -- Baseline snapshot month (YYYY-MM)
    'month2', '2026-02'  -- Comparison snapshot month (YYYY-MM)
  )
);

การวิเคราะห์เอาต์พุต

การค้นหาจะแสดงตารางที่มีแถวสำหรับพื้นที่ทางภูมิศาสตร์ที่ป้อนแต่ละแห่ง

  • เมตริกการเติบโต: เอาต์พุตจะแสดงจำนวนพื้นฐาน (start_count: 89,560) และจำนวนการเปรียบเทียบ (end_count: 90,923) ซึ่งให้ net_change เป็น +1,363 สถานที่ (percentage_change +1.52%)
  • การตรวจสอบข้อมูลจริง: อาร์เรย์ sample_added_place_ids แสดงรหัสสถานที่ที่เฉพาะเจาะจงซึ่งใช้งานได้ใน month2 (กุมภาพันธ์ 2026) ขณะที่ sample_removed_place_ids แสดงรหัสสถานที่ที่ไม่มีอยู่อีกต่อไป
  • การเชื่อมโยงกับ Places API: คุณสามารถส่งรหัสสถานที่ตัวอย่างเหล่านี้ไปยัง Place Details API (ใหม่) ได้โดยตรงเพื่อค้นหา ชื่อร้านค้า ที่อยู่ และแอตทริบิวต์ของธุรกิจที่เพิ่งเปิดหรือปิด

ผลลัพธ์สำหรับฟังก์ชันการเปลี่ยนแปลงจำนวนสถานที่