Funkcja PLACES_COUNT_PER_GEO

Funkcja PLACES_COUNT_PER_GEO przyjmuje tablicę obszarów geograficznych do wyszukania i zwraca tabelę z liczbą miejsc w każdym obszarze. Jeśli na przykład jako obszar wyszukiwania określisz tablicę kodów pocztowych, odpowiedź będzie zawierać tabelę z osobnym wierszem dla każdego kodu pocztowego.

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

  • Parametry wejściowe:

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

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

  • Zwraca:

  • Tabela z jednym wierszem na obszar geograficzny. Tabela zawiera kolumny geography (GEOGRAPHY), count (INT64) i sample_place_ids (ARRAY<STRING>), przy czym kolumna sample_place_ids zawiera maksymalnie 250 identyfikatorów miejsc dla każdego obszaru geograficznego.

Przykład: obliczanie liczby restauracji w każdym hrabstwie Nowego Jorku

Ten przykład generuje tabelę z liczbą działających restauracji w poszczególnych hrabstwach w Nowym Jorku.

W tym przykładzie używamy danych z U.S. Census Bureau, które są publicznym zbiorem danych BigQuery, aby uzyskać granice 3 okręgów w Nowym Jorku: „Queens”, „Kings” i „New York”. Granice każdego hrabstwa znajdują się w kolumnie county_geom.

W tym przykładzie używana jest funkcja BigQuery ST_SIMPLIFY do zwracania uproszczonej wersji funkcji county_geom. Funkcja ST_SIMPLIFY zastępuje prawie proste łańcuchy krawędzi jedną długą krawędzią.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Odpowiedź funkcji:

Wyniki filtrowania według hrabstw w Nowym Jorku.

Wizualizacja wyników

Na tych obrazach widać dane wyświetlane w Looker Studio jako mapa wypełniona kolorem, z obrysem każdego hrabstwa:

Wypełniona mapa do filtrowania sklepów spożywczych i osiedlowych w Nowym Jorku, które są dostępne dla osób na wózkach inwalidzkich.

Aby zaimportować dane do Looker Studio:

  1. Uruchom powyższą funkcję, aby wygenerować wyniki.

  2. W wynikach BigQuery kliknij Otwórz w –> Looker Studio. Wyniki są automatycznie importowane do Looker Studio.

  3. Looker Studio tworzy domyślną stronę raportu i inicjuje ją za pomocą tytułu, tabeli i wykresu słupkowego wyników.

    Raport domyślny w Looker Studio.

  4. Zaznacz wszystko na stronie i usuń.

  5. Aby dodać do raportu mapę wypełnioną, kliknij Wstaw –> Mapa wypełniona.

  6. W sekcji Typy wykresów –> Konfiguracja skonfiguruj pola w sposób pokazany poniżej:

    Konfigurowanie mapy cieplnej w Looker Studio.

  7. Wypełniona mapa będzie wyglądać jak powyżej. Możesz też kliknąć Typy wykresów –> Style, aby dodatkowo skonfigurować wygląd mapy.

Więcej informacji i przykłady wizualizacji wyników Places Insights znajdziesz w artykule Wizualizacja wyników zapytań.