PLACES_COUNT_PER_TYPE işlevi

PLACES_COUNT_PER_TYPE işlevi, işleve belirtilen her türdeki yer için sayıların bulunduğu bir tablo döndürür. Örneğin, doctor, hospital ve pharmacy türlerini aradığınızda yanıtta her tür için ayrı bir satır içeren bir tablo yer alır.

PLACES_COUNT_PER_TYPE işlevi tablo döndürdüğünden, FROM yan tümcesiyle çağırın.

  • Giriş parametreleri:

    • Zorunlu: Arama alanını belirten geography filtre parametresi. geography parametresi, noktaları, çizgi dizilerini ve poligonları destekleyen BigQuery GEOGRAPHY veri türü tarafından tanımlanan bir değer alır.

      Farklı arama coğrafyası türlerini (ör. görünüm alanları ve çizgiler) kullanma örnekleri için PLACES_COUNT işlevine bakın.

    • Zorunlu: Aranacak yer türlerini belirten types filtre parametresi.

    • İsteğe bağlı: Aramanızı daraltmak için ek filtre parametreleri.

  • Şunu döndürür:

    • types değeri başına bir satır içeren tablo. Tabloda type (STRING), count (INT64) ve place_ids (ARRAY<STRING>) sütunları bulunur. place_ids, her type için en fazla 250 yer kimliği içerir.

Örnek: Restoran, kafe ve bar sayısı döndürülür.

Bu örnekte, New York City'de çokgen olarak tanımlanan belirtilen arama alanındaki tüm açık restoran, kafe ve barları ararsınız.

types parametresi, aranacak yer türlerini belirten bir STRING değerleri dizisi alır. Olası değerlerin tam listesi için Yer türleri başlıklı makaleye bakın.

Bu örnekte, bir poligondan GEOGRAPHY değeri döndürmek için BigQuery ST_GEOGFROMTEXT işlevi de kullanılmaktadır.

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

Bu işlev, tür başına bir satır olmak üzere üç satırlık bir tablo döndürür:

New York City&#39;deki Places Count Type işlevi için sonuçlar.

Örnek: Markaya göre filtrelenmiş türe göre iade sayısı

Aşağıdaki örnekte, brand_ids kimlikli Starbucks gibi belirli markaların tür sayılarını almak için brand_ids filtresi kullanılmaktadır:"1413758728321880760"

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', ["cafe", "restaurant"],
      'geography', geo,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ['OPERATIONAL']
      )
);