ภาพรวมฟังก์ชันจํานวนสถานที่

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

• การค้นหาชุดข้อมูลสถานที่จะแสดงผลได้เฉพาะจำนวนที่มากกว่า 5 แต่ไม่มีข้อจำกัดเกี่ยวกับขนาดของพื้นที่ค้นหา

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

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

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

ดูรายชื่อเมืองและประเทศที่รองรับทั้งหมดได้ที่ฟังก์ชันการนับสถานที่อ้างอิงใน BigQuery

ตัวอย่างฟังก์ชันการนับสถานที่

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

SELECT `maps-platform-analytics-hub.sample_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;

การตอบกลับจะมีจำนวนเดียวดังนี้

ในตัวอย่างนี้ คำสั่ง SELECT อ้างอิงฟังก์ชัน PLACES_COUNT สำหรับสหรัฐอเมริกาโดยใช้ไวยากรณ์ต่อไปนี้

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

ดูรายชื่อเมืองและประเทศทั้งหมดที่รองรับได้ที่ ฟังก์ชันการนับสถานที่อ้างอิงใน BigQuery

ใช้ JSON_OBJECT เพื่อส่งอาร์กิวเมนต์ไปยังฟังก์ชัน ตัวอย่างนี้ใช้ฟังก์ชัน 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 `maps-platform-analytics-hub.sample_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

ใช้ตัวกรองกับฟังก์ชัน

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

SELECT `maps-platform-analytics-hub.sample_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;

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

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

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

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

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

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

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

ตารางต่อไปนี้แสดงความแตกต่างที่สําคัญ

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

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