Ringkasan fungsi jumlah tempat

Fungsi jumlah tempat adalah cara lain untuk membuat kueri data Tempat yang tersedia di Insight Tempat. Fungsi ini adalah kueri SQL yang telah ditentukan sebelumnya yang berjalan di BigQuery dan melengkapi kueri data tempat. Perbedaan utamanya adalah bahwa fungsi tidak menerapkan nilai minimum jumlah, tetapi menerapkan area penelusuran minimum:

  • Kueri set data tempat hanya dapat menampilkan jumlah di atas 5, 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 m2).

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. Misalnya, kemampuan untuk menampilkan jumlah rendah penting untuk kasus penggunaan pemilihan lokasi.

Fungsi dan negara jumlah tempat yang didukung

Insight Tempat mendukung fungsi berikut:

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.

Mirip dengan set data tempat, fungsi jumlah tempat tersedia untuk kota teratas di setiap negara yang didukung. Misalnya, untuk Australia, Anda dapat mengakses fungsi jumlah tempat untuk Sydney, Australia.

Untuk mengetahui daftar lengkap kota dan negara yang didukung, lihat Fungsi jumlah tempat rujukan di BigQuery.

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

Respons berisi satu jumlah:

Hasil untuk fungsi Jumlah Tempat di New York City.

Dalam contoh ini, pernyataan SELECT mereferensikan fungsi PLACES_COUNT untuk Amerika Serikat menggunakan sintaksis:

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

Untuk mengetahui daftar lengkap kota dan negara yang didukung, lihat Fungsi jumlah tempat rujukan di BigQuery.

Gunakan JSON_OBJECT untuk meneruskan argumen ke fungsi. 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.

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 mencakup 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 `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']
      )
);

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.

Hasil untuk fungsi Jenis Jumlah Tempat di New York City.

Menerapkan filter ke fungsi

Terapkan filter untuk mempersempit kriteria penelusuran Anda. Fungsi jumlah tempat mendukung banyak filter untuk mempertajam penelusuran Anda. Dalam contoh berikutnya, Anda menerapkan filter untuk membatasi penelusuran berdasarkan rating pengguna minimum, tingkat harga, status bisnis, dan apakah restoran mengizinkan:

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;

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 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 m2).
  • Ukuran input parameter jumlah fungsi penempatan dibatasi hingga 1 MB.
  • Tidak ada dukungan untuk pemfilteran menurut ID tempat atau komponen alamat.

Membandingkan fungsi jumlah tempat dan kueri set data tempat

Tabel berikut mencantumkan perbedaan utama:

Fungsi jumlah tempat Menempatkan kueri set data
Antarmuka Empat fungsi SQL standar yang menghasilkan insight COUNT: jumlah tunggal, jumlah per jenis, jumlah per geografi, jumlah per sel H3. Menggunakan SQL untuk menjalankan fungsi agregasi seperti COUNT, COUNT_IF, SUM dan AVG. Insight tambahan dapat dihasilkan menggunakan JOIN, GROUP BY, WHERE, dan lainnya.
Batasan Menerapkan area penelusuran minimum 40,0 meter x 40,0 meter (1.600 m2). Fungsi menampilkan hasil meskipun jumlah agregasi kurang dari 5 selama area penelusuran minimum terpenuhi. Menerapkan batas jumlah 5, tetapi tidak ada area penelusuran minimum.
Filter atribut yang didukung Skema lengkap yang didukung, kecuali:
  • Tempat id
  • Komponen alamat
 Skema lengkap didukung
Manfaat
  • Dapat menampilkan jumlah apa pun.
  • Dioptimalkan untuk performa dan biaya pemrosesan yang rendah.
  • Mudah digunakan. Tidak perlu menulis kueri yang rumit.
  • Memvalidasi parameter input dan menampilkan error sehingga lebih mudah digunakan dan di-debug.
  • Memungkinkan kueri kompleks seperti pemfilteran lanjutan dan gabungan.
  • Tidak menerapkan area penelusuran minimum.
  • Mendukung fungsi agregat tambahan selain COUNT seperti AVG, SUM, dan GROUP BY.

Merujuk fungsi jumlah tempat di BigQuery

Fungsi jumlah tempat mendukung kota dan negara berikut. Anda harus berlangganan untuk setiap kota dan negara secara terpisah.

Kota, Negara Nama tabel
Sydney, Australia maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME
Sao Paulo, Brasil maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME
Toronto, Kanada maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME
Paris, Prancis maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME
Berlin, Jerman maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME
London, Britania Raya maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME
Mumbai, India maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME
Jakarta, Indonesia maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME
Roma, Italia maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME
Tokyo, Jepang maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME
Mexico City, Meksiko maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME
Madrid, Spanyol maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME
Zurich, Swiss maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME
New York City, Amerika Serikat maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME