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 fungsi tersebut menggunakan klausa FROM.

  • Parameter input:

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

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

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

    • Opsional: Parameter filter tambahan untuk menyaring penelusuran.

  • Returns:

    • Tabel dengan satu baris per nilai types. Tabel berisi kolom type (STRING), count (INT64), dan place_ids (ARRAY<STRING>) dengan 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 yang ditentukan sebagai poligon di New York City.

Parameter types menggunakan array nilai STRING yang menentukan jenis tempat yang akan ditelusuri. Untuk daftar lengkap nilai yang mungkin, lihat Jenis tempat.

Contoh ini juga menggunakan fungsi BigQuery ST_GEOGFROMTEXT untuk menampilkan nilai GEOGRAPHYdari 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 `PROJECT_NAME.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.