Funkcja PLACES_COUNT_PER_TYPE

Funkcja PLACES_COUNT_PER_TYPE zwraca tabelę z liczbą wystąpień każdego typu miejsca określonego w funkcji. Jeśli na przykład wyszukasz typy doctor, hospital i pharmacy, odpowiedź będzie zawierać tabelę z osobnym wierszem dla każdego typu.

Funkcja PLACES_COUNT_PER_TYPE zwraca tabelę, więc wywołaj ją za pomocą klauzuli FROM.

  • Parametry wejściowe:

    • Wymagany: geography parametr filtra, który określa obszar wyszukiwania. Parametr geography przyjmuje wartość zdefiniowaną przez typ danych BigQuery GEOGRAPHY, który obsługuje punkty, linie i wielokąty.

      Przykłady użycia różnych typów obszarów geograficznych wyszukiwania, takich jak widoki i linie, znajdziesz w sekcji PLACES_COUNT funkcja.

    • Wymagany: types parametr filtra, który określa typy miejsc do wyszukania.

    • Opcjonalnie: dodatkowe parametry filtra, które pozwalają zawęzić wyszukiwanie.

  • Zwraca:

  • Tabela z jednym wierszem na każdą wartość types. Tabela zawiera kolumny type (STRING), count (INT64) i sample_place_ids (ARRAY<STRING>), gdzie sample_place_ids zawiera maksymalnie 250 identyfikatorów miejsc dla każdego elementu type.

Przykład: liczba wyników wyszukiwania restauracji, kawiarni i barów

W tym przykładzie wyszukujesz wszystkie działające restauracje, kawiarnie i bary w określonym obszarze wyszukiwania zdefiniowanym jako wielokąt w Nowym Jorku.

Parametr types przyjmuje tablicę wartości STRING określających typy miejsc, których należy szukać. Pełną listę możliwych wartości znajdziesz w tabeli A i tabeli B w artykule Typy miejsc.

W tym przykładzie użyto też funkcji BigQuery ST_GEOGFROMTEXT do zwrócenia wartości GEOGRAPHY z wielokąta.

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

Ta funkcja zwraca tabelę z 3 wierszami, po jednym dla każdego typu:

Wyniki funkcji Place Count Type w Warszawie.