Funkcja PLACES_COUNT_PER_H3

Funkcja PLACES_COUNT_PER_H3 przyjmuje obszar geograficzny do wyszukania i zwraca tabelę z liczbą miejsc w komórce H3 w obszarze wyszukiwania.

Ponieważ funkcja PLACES_COUNT_PER_H3 zwraca tabelę, wywołaj ją za pomocą klauzuli FROM.

  • Parametry wejściowe:

    • Wymagany: geography parametr filtra, który określa obszar wyszukiwania. Parametr geography ma 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 widoczny obszar i linie, znajdziesz w sekcji PLACES_COUNT funkcja.

    • Wymagany: h3_resolution parametr filtra, który określa rozdzielczość H3 używaną do agregowania liczby miejsc w każdej komórce H3. Obsługiwane wartości to od 0 do 11.

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

  • Zwraca:

    • Tabela z 1 wierszem na komórkę H3. Tabela zawiera kolumny h3_cell_index (STRING), geography (GEOGRAPHY), która określa wielokąt reprezentujący komórkę H3, count (INT64) i sample_place_ids (ARRAY<STRING>), gdzie sample_place_ids zawiera maksymalnie 250 identyfikatorów miejsc w każdej komórce H3.

Przykład: zliczanie sklepów ogólnospożywczych i spożywczych dostępnych dla osób na wózkach inwalidzkich w komórce H3

Poniższy przykład oblicza liczbę działających sklepów ogólnospożywczych i spożywczych dostępnych dla osób na wózkach inwalidzkich w komórce H3 w Nowym Jorku. Komórki H3 używają poziomu rozdzielczości 8.

Ten przykład korzysta z Overture Maps Data BigQuery publicznego zbioru danych, aby uzyskać obszar geograficzny Nowego Jorku.

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND subtype = 'locality' AND names.primary = 'New York'  LIMIT 1);

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

Odpowiedź funkcji:

Wyniki filtrowania sklepów spożywczych i osiedlowych z dostępem dla osób poruszających się na wózku w Nowym Jorku.

Wizualizacja wyników

Na ilustracjach poniżej widać te dane wyświetlane w Looker Studio jako mapa wypełniona. Im ciemniejsza komórka H3, tym większe zagęszczenie wyników:

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

Aby zaimportować dane do Looker Studio:

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

  2. W wynikach BigQuery kliknij Otwórz w -> Looker Studio. Wyniki zostaną automatycznie zaimportowane do Looker Studio.

  3. Looker Studio utworzy domyślną stronę raportu i zainicjuje ją tytułem, tabelą i wykresem słupkowym 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 tak jak poniżej:

    Konfigurowanie mapy termicznej w Looker Studio.

  7. Mapa wypełniona będzie wyglądać jak powyżej. Opcjonalnie możesz kliknąć Typy wykresów -> Style , aby dodatkowo skonfigurować wygląd mapy.

Więcej informacji i przykład wizualizacji wyników Statystyk miejsc znajdziesz w sekcji Wizualizacja wyników zapytania.