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

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

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

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

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

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

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

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

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

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

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

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

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

เช่น

PROJECT_NAME.places_insights___us.PLACES_COUNT

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

กรองผลลัพธ์

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

ในตัวอย่างถัดไป คุณจะใช้ตัวกรองเพื่อจำกัดการค้นหาตามคะแนนขั้นต่ำของผู้ใช้ ระดับราคา สถานะธุรกิจ และดูว่าร้านอาหารอนุญาตให้นำสุนัขเข้าไปหรือไม่ โดยใช้ฟังก์ชัน 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 กับตารางภูมิศาสตร์ของอินพุตที่กำหนดเอง my_search_area เพื่อแสดงจำนวนร้านอาหารที่เปิดให้บริการ ภายในรัศมี 1,000 เมตรจากเอ็มไพร์สเตตบิลดิงและไทม์สแควร์ใน นครนิวยอร์ก

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"]
      )
);

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

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

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

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

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

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

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

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

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

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

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

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

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

จังหวัด ประเทศ ชื่อตาราง
บัวโนสไอเรส อาร์เจนตินา places_insights___ar___sample.FUNCTION_NAME
ซิดนีย์ ออสเตรเลีย places_insights___au___sample.FUNCTION_NAME
Bad Gastein, ออสเตรีย places_insights___at___sample.FUNCTION_NAME
ริฟฟาห์ บาห์เรน places_insights___bh___sample.FUNCTION_NAME
กรุงบรัสเซลส์ เบลเยียม places_insights___be___sample.FUNCTION_NAME
เซาเปาลู บราซิล places_insights___br___sample.FUNCTION_NAME
พลอฟดิฟ บัลแกเรีย places_insights___bg___sample.FUNCTION_NAME
โทรอนโต, แคนาดา places_insights___ca___sample.FUNCTION_NAME
ซันติอาโก ชิลี places_insights___cl___sample.FUNCTION_NAME
เมเดยิน โคลอมเบีย places_insights___co___sample.FUNCTION_NAME
เบอร์โน เช็กเกีย places_insights___cz___sample.FUNCTION_NAME
โคเปนเฮเกน เดนมาร์ก places_insights___dk___sample.FUNCTION_NAME
ไคโร อียิปต์ places_insights___eg___sample.FUNCTION_NAME
เฮลซิงกิ ฟินแลนด์ places_insights___fi___sample.FUNCTION_NAME
ปารีส ฝรั่งเศส places_insights___fr___sample.FUNCTION_NAME
เบอร์ลิน เยอรมนี places_insights___de___sample.FUNCTION_NAME
เอเธนส์ กรีซ places_insights___gr___sample.FUNCTION_NAME
ฮ่องกง ฮ่องกง places_insights___hk___sample.FUNCTION_NAME
เดเบรเซน ฮังการี places_insights___hu___sample.FUNCTION_NAME
มุมไบ อินเดีย places_insights___in___sample.FUNCTION_NAME
จาการ์ตา อินโดนีเซีย places_insights___id___sample.FUNCTION_NAME
คอร์ก ไอร์แลนด์ places_insights___ie___sample.FUNCTION_NAME
เทลอาวีฟ-ยาโฟ อิสราเอล places_insights___il___sample.FUNCTION_NAME
โรม อิตาลี places_insights___it___sample.FUNCTION_NAME
โตเกียว ญี่ปุ่น places_insights___jp___sample.FUNCTION_NAME
ปูซาน เกาหลีใต้ places_insights___kr___sample.FUNCTION_NAME
กัวลาลัมเปอร์ มาเลเซีย places_insights___my___sample.FUNCTION_NAME
เม็กซิโกซิตี้ เม็กซิโก places_insights___mx___sample.FUNCTION_NAME
Amsterdam, Netherlands places_insights___nl___sample.FUNCTION_NAME
เวลลิงตัน นิวซีแลนด์ places_insights___nz___sample.FUNCTION_NAME
ออสโล, นอร์เวย์ places_insights___no___sample.FUNCTION_NAME
Arequipa, เปรู places_insights___pe___sample.FUNCTION_NAME
มะนิลา ฟิลิปปินส์ places_insights___ph___sample.FUNCTION_NAME
วอร์ซอ โปแลนด์ places_insights___pl___sample.FUNCTION_NAME
ลิสบอน โปรตุเกส places_insights___pt___sample.FUNCTION_NAME
ลูซาอิล กาตาร์ places_insights___qa___sample.FUNCTION_NAME
บูคาเรสต์ โรมาเนีย places_insights___ro___sample.FUNCTION_NAME
เจดดาห์ ซาอุดีอาระเบีย places_insights___sa___sample.FUNCTION_NAME
กรุงสิงคโปร์ สิงคโปร์ places_insights___sg___sample.FUNCTION_NAME
โจฮันเนสเบิร์ก, แอฟริกาใต้ places_insights___za___sample.FUNCTION_NAME
มาดริด สเปน places_insights___es___sample.FUNCTION_NAME
สตอกโฮล์ม สวีเดน places_insights___se___sample.FUNCTION_NAME
ซูริก สวิตเซอร์แลนด์ places_insights___ch___sample.FUNCTION_NAME
ไทเป, ไต้หวัน places_insights___tw___sample.FUNCTION_NAME
เชียงใหม่ ประเทศไทย places_insights___th___sample.FUNCTION_NAME
อังการา ตุรกี places_insights___tr___sample.FUNCTION_NAME
Sharjah, สหรัฐอาหรับเอมิเรตส์ places_insights___ae___sample.FUNCTION_NAME
ลอนดอน สหราชอาณาจักร places_insights___gb___sample.FUNCTION_NAME
นครนิวยอร์ก สหรัฐอเมริกา places_insights___us___sample.FUNCTION_NAME
ฮานอย, เวียดนาม places_insights___vn___sample.FUNCTION_NAME

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

ประเทศ ชื่อตาราง
อาร์เจนตินา places_insights___ar.FUNCTION_NAME
ออสเตรเลีย places_insights___au.FUNCTION_NAME
ออสเตรีย places_insights___at.FUNCTION_NAME
บาห์เรน places_insights___bh.FUNCTION_NAME
เบลเยียม places_insights___be.FUNCTION_NAME
บราซิล places_insights___br.FUNCTION_NAME
บัลแกเรีย places_insights___bg.FUNCTION_NAME
แคนาดา places_insights___ca.FUNCTION_NAME
ชิลี places_insights___cl.FUNCTION_NAME
โคลอมเบีย places_insights___co.FUNCTION_NAME
เช็กเกีย places_insights___cz.FUNCTION_NAME
เดนมาร์ก places_insights___dk.FUNCTION_NAME
อียิปต์ places_insights___eg.FUNCTION_NAME
ฟินแลนด์ places_insights___fi.FUNCTION_NAME
ฝรั่งเศส places_insights___fr.FUNCTION_NAME
เยอรมนี places_insights___de.FUNCTION_NAME
กรีซ places_insights___gr.FUNCTION_NAME
ฮ่องกง places_insights___hk.FUNCTION_NAME
ฮังการี places_insights___hu.FUNCTION_NAME
อินเดีย places_insights___in.FUNCTION_NAME
อินโดนีเซีย places_insights___id.FUNCTION_NAME
ไอร์แลนด์ places_insights___ie.FUNCTION_NAME
อิสราเอล places_insights___il.FUNCTION_NAME
อิตาลี places_insights___it.FUNCTION_NAME
ญี่ปุ่น places_insights___jp.FUNCTION_NAME
มาเลเซีย places_insights___my.FUNCTION_NAME
เม็กซิโก places_insights___mx.FUNCTION_NAME
เนเธอร์แลนด์ places_insights___nl.FUNCTION_NAME
นิวซีแลนด์ places_insights___nz.FUNCTION_NAME
นอร์เวย์ places_insights___no.FUNCTION_NAME
เปรู places_insights___pe.FUNCTION_NAME
ฟิลิปปินส์ places_insights___ph.FUNCTION_NAME
โปแลนด์ places_insights___pl.FUNCTION_NAME
โปรตุเกส places_insights___pt.FUNCTION_NAME
กาตาร์ places_insights___qa.FUNCTION_NAME
โรมาเนีย places_insights___ro.FUNCTION_NAME
ซาอุดีอาระเบีย places_insights___sa.FUNCTION_NAME
สิงคโปร์ places_insights___sg.FUNCTION_NAME
แอฟริกาใต้ places_insights___za.FUNCTION_NAME
เกาหลีใต้ places_insights___kr.FUNCTION_NAME
สเปน places_insights___es.FUNCTION_NAME
สวีเดน places_insights___se.FUNCTION_NAME
สวิตเซอร์แลนด์ places_insights___ch.FUNCTION_NAME
ไต้หวัน places_insights___tw.FUNCTION_NAME
ไทย places_insights___th.FUNCTION_NAME
ตุรกี places_insights___tr.FUNCTION_NAME
สหรัฐอาหรับเอมิเรตส์ places_insights___ae.FUNCTION_NAME
สหราชอาณาจักร places_insights___gb.FUNCTION_NAME
สหรัฐอเมริกา places_insights___us.FUNCTION_NAME
เวียดนาม places_insights___vn.FUNCTION_NAME