Mengkueri set data menggunakan fungsi Jumlah Tempat

Fungsi Jumlah Tempat adalah kueri SQL yang telah ditentukan sebelumnya yang berjalan di BigQuery dan bersifat komplementer untuk membuat kueri set data secara langsung. Perbedaan utama antara membuat kueri data secara langsung dan menggunakan fungsi adalah fungsi tidak menerapkan nilai minimum jumlah, tetapi menerapkan area penelusuran minimum:

• Kueri set data tempat hanya dapat menampilkan jumlah 5 dan lebih tinggi, tetapi tidak memberlakukan batasan pada ukuran area penelusuran.
• Fungsi Jumlah Tempat dapat menampilkan jumlah apa pun, termasuk 0, tetapi menerapkan area penelusuran minimum 40,0 meter x 40,0 meter (1.600 m²). Fungsi juga dapat menampilkan ID Tempat, yang dapat digunakan untuk mencari informasi tentang setiap Tempat.

Anda mungkin ingin menggunakan fungsi Jumlah Tempat jika penting untuk mengetahui kapan kueri tidak menampilkan hasil atau jika Anda perlu mengetahui jumlah tempat yang rendah di bawah 5. Hal ini juga berguna jika Anda perlu mendapatkan informasi tempat tertentu untuk memeriksa hasil Anda.

Fungsi Jumlah Tempat hanya memberikan jumlah, jadi jika Anda perlu menjalankan kueri yang lebih kompleks seperti gabungan data, atau mendapatkan insight tambahan seperti rating rata-rata sekelompok tempat, kueri set data secara langsung.

Fungsi dan negara yang didukung untuk Jumlah Tempat

Insight Tempat mendukung fungsi berikut:

• science PLACES_COUNT_V2: Menampilkan tabel yang berisi jumlah tempat dan contoh ID Tempat. Fungsi ini menerima parameter tabel untuk input multi-geografi, sehingga memungkinkan pemrosesan batch yang efisien. Fungsi ini sangat dioptimalkan untuk gabungan geospasial dibandingkan dengan fungsi PLACES_COUNT dan PLACES_COUNT_PER_GEO.
• science PLACES_COUNT_PER_TYPE_V2: Menampilkan tabel jumlah tempat dan contoh ID Tempat, yang dikategorikan menurut jenis tempat. Mirip dengan PLACES_COUNT_V2, fungsi ini menerima parameter tabel untuk memproses beberapa geografi input secara bersamaan. Arsitektur ini mendukung pemrosesan batch yang efisien dan menyediakan penggabungan geospasial yang dioptimalkan dibandingkan dengan PLACES_COUNT_PER_TYPE.
• PLACES_COUNT_PER_H3: Menampilkan tabel BigQuery berisi jumlah tempat per sel H3.
• PLACES_COUNT: Menampilkan satu baris yang berisi jumlah tempat.
• PLACES_COUNT_PER_TYPE: Menampilkan tabel BigQuery jumlah tempat per jenis tempat.
• PLACES_COUNT_PER_GEO: Menampilkan tabel BigQuery yang berisi jumlah tempat per geografi.

Selain jumlah tempat, semua fungsi kecuali PLACES_COUNT juga menampilkan hingga 250 ID tempat per elemen respons.

ID Tempat dapat digunakan dengan:

• Places API (Baru)
• Geocoding API
• Kit UI Tempat

Menulis kueri dengan fungsi

Gunakan format berikut untuk memanggil fungsi: [project name (optional)].[table name].[function name].

Jika Anda mengubah nama set data tertaut saat menyiapkan Insight Tempat, gunakan nama kustom Anda, bukan nama tabel default yang tercantum dalam Fungsi jumlah tempat rujukan di BigQuery. Anda juga dapat menyertakan nama project Anda secara opsional. Jika tidak disertakan, kueri akan ditetapkan secara default ke project aktif.

Contoh:

PROJECT_NAME.places_insights___us.PLACES_COUNT

Gunakan JSON_OBJECT untuk meneruskan argumen ke fungsi.

Memfilter hasil

Fungsi Jumlah Tempat mendukung banyak filter untuk menyaring penelusuran Anda. Parameter ini (misalnya, price_level atau types) peka huruf besar/kecil dan harus cocok dengan nama parameter secara persis. Lihat referensi parameter filter untuk mengetahui daftar lengkap opsi.

Dalam contoh berikutnya, Anda menerapkan filter untuk membatasi penelusuran menurut rating pengguna minimum, tingkat harga, status bisnis, dan apakah restoran mengizinkan, menggunakan fungsi PLACES_COUNT_V2.

Pertama, gunakan tabel geografi input Anda atau siapkan tabel dengan geografi yang dipilih:

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

Selanjutnya, panggil PLACES_COUNT_V2 dengan tabel dan objek JSON yang berisi filter. Radius penelusuran disertakan dalam filter JSON dan akan diterapkan di sekitar setiap titik dalam tabel 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
      )
);

Contoh fungsi Jumlah Tempat

Contoh berikut menggunakan fungsi PLACES_COUNT_V2 dengan tabel geografi input kustom my_search_area untuk menampilkan jumlah restoran yang beroperasi dalam radius 1.000 meter dari Empire State Building dan Times Square di New York City:

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

Responsnya adalah tabel BigQuery yang berisi geo_id, geografi, jumlah, dan contoh ID tempat.

Memvisualisasikan hasil

Alat analisis dan business intelligencesangat penting untuk membantu Anda menemukan insight dari data BigQuery. BigQuery mendukung beberapa alat visualisasi data Google dan pihak ketiga yang dapat Anda gunakan untuk menganalisis hasil fungsi Anda pada data Places Insights.

Untuk contoh memvisualisasikan hasil fungsi, lihat Memvisualisasikan hasil. Untuk mengetahui informasi dan contoh selengkapnya tentang cara memvisualisasikan hasil Insight Tempat, lihat Memvisualisasikan hasil kueri.

Batasan dan persyaratan

Fungsi Jumlah Tempat memiliki batasan dan persyaratan berikut:

• Hanya insight COUNT yang didukung.
• Diperlukan area penelusuran minimum 40,0 meter x 40,0 meter (1.600 m²).
• Batas Ukuran Input Parameter: Objek JSON yang diteruskan sebagai parameter ke fungsi dibatasi hingga 1 MB. Dampak batas ini bergantung pada versi fungsi:
• Untuk fungsi V2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2), batas ini hanya berlaku untuk objek JSON filter. Karena geografi disediakan secara terpisah menggunakan parameter tabel, fungsi ini dapat diskalakan ke jumlah geografi input yang jauh lebih besar tanpa mencapai batas ukuran JSON.
  • Untuk PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE, dan PLACES_COUNT_PER_GEO, batas ini berlaku untuk seluruh objek JSON, termasuk semua definisi geografi. Hal ini dapat membatasi jumlah geografi yang dapat diproses dalam satu panggilan.
• Tidak ada dukungan untuk pemfilteran menurut ID tempat, merek, opsi pengisian daya kendaraan listrik, atau komponen alamat.
• Anda hanya dapat mengakses fungsi Jumlah Tempat untuk kota dan negara yang telah Anda langgani. Lihat Menyiapkan Places Insights untuk akses set data.
• Parameter filter (misalnya, geography atau types) peka huruf besar/kecil dan harus cocok dengan nama parameter secara persis, atau kueri akan gagal.

Merujuk fungsi Jumlah Tempat di BigQuery

Semua kota dalam set data contoh dan set data lengkap negara mendukung fungsi Jumlah Tempat.

Anda memiliki akses ke fungsi Jumlah Tempat yang sesuai dengan set data kota dan negara yang telah Anda ikuti. Lihat Menyiapkan Places Insights untuk akses set data.

Tabel ini mencantumkan kota dan negara yang tersedia, serta nama tabel yang sesuai.

Contoh data

Data lengkap