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

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

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

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

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

ฟังก์ชันและประเทศที่รองรับสำหรับจำนวนสถานที่

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

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

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

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

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

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

เช่น

PROJECT_NAME.places_insights___us.PLACES_COUNT

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

กรองผลลัพธ์

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

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

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

ฟังก์ชันจำนวนสถานที่ตั้งมีข้อจำกัดและข้อกำหนดต่อไปนี้

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

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

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

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

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

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

จังหวัด ประเทศ	ชื่อตาราง
ซิดนีย์ ออสเตรเลีย	`places_insights___au___sample.FUNCTION_NAME`
เซาเปาลู บราซิล	`places_insights___br___sample.FUNCTION_NAME`
โทรอนโต, แคนาดา	`places_insights___ca___sample.FUNCTION_NAME`
ปารีส ฝรั่งเศส	`places_insights___fr___sample.FUNCTION_NAME`
เบอร์ลิน เยอรมนี	`places_insights___de___sample.FUNCTION_NAME`
มุมไบ อินเดีย	`places_insights___in___sample.FUNCTION_NAME`
จาการ์ตา อินโดนีเซีย	`places_insights___id___sample.FUNCTION_NAME`
โรม อิตาลี	`places_insights___it___sample.FUNCTION_NAME`
โตเกียว ญี่ปุ่น	`places_insights___jp___sample.FUNCTION_NAME`
เม็กซิโกซิตี้ เม็กซิโก	`places_insights___mx___sample.FUNCTION_NAME`
มาดริด สเปน	`places_insights___es___sample.FUNCTION_NAME`
ซูริก สวิตเซอร์แลนด์	`places_insights___ch___sample.FUNCTION_NAME`
ลอนดอน สหราชอาณาจักร	`places_insights___gb___sample.FUNCTION_NAME`
นครนิวยอร์ก สหรัฐอเมริกา	`places_insights___us___sample.FUNCTION_NAME`

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

ประเทศ	ชื่อตาราง
ออสเตรเลีย	`places_insights___au.FUNCTION_NAME`
บราซิล	`places_insights___br.FUNCTION_NAME`
แคนาดา	`places_insights___ca.FUNCTION_NAME`
ฝรั่งเศส	`places_insights___fr.FUNCTION_NAME`
เยอรมนี	`places_insights___de.FUNCTION_NAME`
อินเดีย	`places_insights___in.FUNCTION_NAME`
อินโดนีเซีย	`places_insights___id.FUNCTION_NAME`
อิตาลี	`places_insights___it.FUNCTION_NAME`
ญี่ปุ่น	`places_insights___jp.FUNCTION_NAME`
เม็กซิโก	`places_insights___mx.FUNCTION_NAME`
สเปน	`places_insights___es.FUNCTION_NAME`
สวิตเซอร์แลนด์	`places_insights___ch.FUNCTION_NAME`
สหราชอาณาจักร	`places_insights___gb.FUNCTION_NAME`
สหรัฐอเมริกา	`places_insights___us.FUNCTION_NAME`