Fungsi PLACES_COUNT_PER_TYPE

Fungsi PLACES_COUNT_PER_TYPE menampilkan tabel jumlah untuk setiap jenis tempat yang ditentukan ke fungsi. Misalnya, jika Anda menelusuri jenis doctor, hospital, dan pharmacy, respons akan berisi tabel dengan baris terpisah untuk setiap jenis.

Karena fungsi PLACES_COUNT_PER_TYPE menampilkan tabel, panggil menggunakan klausa FROM.

  • Parameter input:

    • Wajib: Parameter filter geography yang menentukan area penelusuran. Parameter geography mengambil nilai yang ditentukan oleh jenis data GEOGRAPHY BigQuery, yang mendukung titik, linestring, dan poligon.

      Untuk contoh penggunaan berbagai jenis geografi penelusuran, seperti area tampilan dan garis, lihat fungsi PLACES_COUNT.

    • Wajib: Parameter filter types yang menentukan jenis tempat yang akan ditelusuri.

    • Opsional: Parameter filter tambahan untuk menyaring penelusuran Anda.

  • Retur:

  • Tabel dengan satu baris per nilai types. Tabel berisi kolom type (STRING), count (INT64), dan sample_place_ids (ARRAY<STRING>) dengan sample_place_ids berisi hingga 250 ID tempat untuk setiap type.

Contoh: Menampilkan jumlah restoran, kafe, dan bar

Dalam contoh ini, Anda menelusuri semua restoran, kafe, dan bar yang beroperasi di area penelusuran tertentu yang ditentukan sebagai poligon di New York City.

Parameter types menggunakan array nilai STRING yang menentukan jenis tempat yang akan ditelusuri. Untuk mengetahui daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di Jenis tempat.

Contoh ini juga menggunakan fungsi ST_GEOGFROMTEXT BigQuery untuk menampilkan nilai GEOGRAPHY dari poligon.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

Fungsi ini menampilkan tabel dengan tiga baris, satu per jenis:

Hasil untuk fungsi Jenis Jumlah Tempat di New York City.