Membuat kueri set data menggunakan fungsi jumlah tempat

Fungsi jumlah tempat adalah kueri SQL yang telah ditentukan sebelumnya yang berjalan di BigQuery dan melengkapi 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, 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 Tempat tertentu.

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 jumlah tempat yang didukung

Insight Tempat mendukung fungsi berikut:

• PLACES_COUNT: Menampilkan satu baris yang berisi jumlah tempat.
• PLACES_COUNT_PER_TYPE: Menampilkan tabel BigQuery yang berisi jumlah tempat per jenis tempat.
• PLACES_COUNT_PER_GEO: Menampilkan tabel BigQuery yang berisi jumlah tempat per geografi.
• PLACES_COUNT_PER_H3: Menampilkan tabel BigQuery yang berisi jumlah tempat per sel H3.

Selain jumlah tempat, fungsi PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO, dan PLACES_COUNT_PER_H3 juga menampilkan hingga 250 ID tempat per elemen respons. Lihat semua parameter filter.

ID Tempat dapat digunakan dengan:

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

Catatan: Anda dapat mengakses fungsi jumlah tempat untuk kota dan negara yang sama dengan yang Anda miliki

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 di sini. Anda juga dapat menyertakan nama project Anda secara opsional. Jika tidak disertakan, kueri akan secara default ditetapkan ke project aktif.

Contoh:

PROJECT_NAME.places_insights___us.PLACES_COUNT

Gunakan JSON_OBJECT untuk meneruskan argumen ke fungsi.

Catatan: Saat Anda menggunakan fungsi jumlah tempat, fungsi ditentukan dalam klausa FROM dan WITH_AGGREGATION_THRESHOLD dihilangkan.

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:

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;

Catatan: Sertakan filter business_status untuk memastikan Anda mendapatkan jumlah bisnis OPERATIONAL. Jika tidak, jumlahnya mencakup bisnis yang tutup.

Contoh fungsi jumlah tempat

Contoh berikut menggunakan fungsi PLACES_COUNT untuk menampilkan jumlah restoran yang beroperasi dalam radius 1.000 meter dari Empire State Building di New York City:

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;

Respons berisi satu jumlah:

Contoh ini menggunakan fungsi ST_GEOGPOINT BigQuery untuk menampilkan nilai GEOGRAPHY dari suatu titik, lalu meneruskan nilai tersebut ke parameter geography. Selain itu, API ini juga meneruskan radius penelusuran di sekitar titik dan jenis tempat, "restaurant", yang akan ditelusuri.

Catatan: Parameter wajib dan opsional berbeda untuk setiap fungsi jumlah tempat seperti yang dijelaskan dalam filter.

Contoh jumlah tempat per jenis, geografi, atau H3

Selain jumlah tempat, fungsi PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO, dan PLACES_COUNT_PER_H3 juga menampilkan hingga 250 ID tempat untuk tempat yang disertakan dalam respons.

Misalnya, fungsi PLACES_COUNT_PER_TYPE menampilkan tabel jumlah tempat per jenis tempat. Responsnya menyertakan array ID tempat untuk tempat yang cocok dengan setiap jenis. Anda dapat menggunakan ID tempat yang ditampilkan untuk mencari informasi tentang setiap tempat.

Panggilan fungsi berikut menampilkan jumlah tempat dengan jenis: restaurant, cafe, dan 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']
      )
);

Fungsi ini menampilkan tabel dengan tiga kolom: type, count, dan sample_place_ids. Kolom count menampilkan jumlah tempat untuk setiap type, dan kolom sample_place_ids menampilkan hingga 250 ID tempat untuk setiap type.

Catatan: Untuk mendapatkan informasi tentang suatu tempat, gunakan ID Tempat untuk memanggil Places API atau kit UI Places. Memvalidasi data Insight Tempat menggunakan contoh Place ID memberikan contoh.

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²).
• Ukuran input parameter jumlah fungsi penempatan dibatasi hingga 1 MB.
• 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 ikuti. 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.