Mengkueri set data menggunakan fungsi Jumlah Tempat

Fungsi Jumlah Tempat adalah kueri SQL yang telah ditentukan sebelumnya yang berjalan di BigQuery dan bersifat pelengkap 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, 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 yang didukung untuk Jumlah Tempat

Insight Tempat mendukung fungsi berikut:

• 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.
• 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 dapat Anda akses.

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 (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.

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 jarak 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. Respons 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 intelligence sangat 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 visualisasi 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 memfilter 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.

Catatan: Jika Anda mengubah nama set data tertaut saat menyiapkan Insight Tempat, gunakan nama kustom, bukan nama tabel default yang tercantum di sini. Anda juga dapat menyertakan nama project Anda. Jika salah satunya tidak disertakan, kueri akan ditetapkan secara default ke project aktif.

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

Contoh data

Kota, Negara	Nama tabel
Sydney, Australia	places_insights___au___sample.FUNCTION_NAME
Sao Paulo, Brasil	places_insights___br___sample.FUNCTION_NAME
Toronto, Kanada	places_insights___ca___sample.FUNCTION_NAME
Paris, Prancis	places_insights___fr___sample.FUNCTION_NAME
Berlin, Jerman	places_insights___de___sample.FUNCTION_NAME
Mumbai, India	places_insights___in___sample.FUNCTION_NAME
Jakarta, Indonesia	places_insights___id___sample.FUNCTION_NAME
Roma, Italia	places_insights___it___sample.FUNCTION_NAME
Tokyo, Jepang	places_insights___jp___sample.FUNCTION_NAME
Mexico City, Meksiko	places_insights___mx___sample.FUNCTION_NAME
Madrid, Spanyol	places_insights___es___sample.FUNCTION_NAME
Zurich, Swiss	places_insights___ch___sample.FUNCTION_NAME
London, Inggris Raya	places_insights___gb___sample.FUNCTION_NAME
New York City, Amerika Serikat	places_insights___us___sample.FUNCTION_NAME

Data lengkap

Negara	Nama tabel
Australia	places_insights___au.FUNCTION_NAME
Brasil	places_insights___br.FUNCTION_NAME
Kanada	places_insights___ca.FUNCTION_NAME
Prancis	places_insights___fr.FUNCTION_NAME
Jerman	places_insights___de.FUNCTION_NAME
India	places_insights___in.FUNCTION_NAME
Indonesia	places_insights___id.FUNCTION_NAME
Italia	places_insights___it.FUNCTION_NAME
Jepang	places_insights___jp.FUNCTION_NAME
Meksiko	places_insights___mx.FUNCTION_NAME
Spanyol	places_insights___es.FUNCTION_NAME
Swiss	places_insights___ch.FUNCTION_NAME
Inggris Raya	places_insights___gb.FUNCTION_NAME
Amerika Serikat	places_insights___us.FUNCTION_NAME