Wysyłanie zapytań do zbioru danych za pomocą funkcji Places Count

Funkcje Places Count to predefiniowane zapytania SQL, które są uruchamiane w BigQuery i stanowią uzupełnienie bezpośredniego wykonywania zapytań w zbiorze danych. Główna różnica między wysyłaniem zapytań bezpośrednio do danych a używaniem funkcji polega na tym, że funkcje nie wymuszają minimalnego progu liczby, ale minimalny obszar wyszukiwania:

• Zapytania dotyczące zbiorów danych o miejscach mogą zwracać tylko wartości większe lub równe 5, ale nie mają ograniczeń co do wielkości obszaru wyszukiwania.
• Funkcje zliczania miejsc mogą zwracać dowolne liczby, w tym 0, ale wymagają minimalnego obszaru wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m²). Funkcje mogą też zwracać identyfikatory miejsc, których można używać do wyszukiwania informacji o poszczególnych miejscach.

Funkcji Places Count możesz używać, jeśli ważne jest dla Ciebie, aby wiedzieć, kiedy zapytanie nie zwraca żadnych wyników, lub gdy potrzebujesz informacji o niskiej liczbie miejsc (poniżej 5). Jest to też przydatne, jeśli chcesz uzyskać informacje o poszczególnych miejscach, aby sprawdzić wyniki.

Funkcje Places Count podają tylko liczby, więc jeśli chcesz wykonywać bardziej złożone zapytania, np. łączyć dane, lub uzyskiwać dodatkowe statystyki, takie jak średnia ocena grupy miejsc, wykonuj zapytania bezpośrednio w zbiorze danych.

Obsługiwane funkcje i kraje

Places Insights obsługuje te funkcje:

• science PLACES_COUNT_V2: zwraca tabelę zawierającą liczbę miejsc i przykładowe identyfikatory miejsc. Ta funkcja akceptuje parametr tabeli dla danych z wielu lokalizacji geograficznych, co umożliwia wydajne przetwarzanie wsadowe. Jest ona wysoce zoptymalizowana pod kątem łączenia danych geoprzestrzennych w porównaniu z funkcjami PLACES_COUNT i PLACES_COUNT_PER_GEO.
• science PLACES_COUNT_PER_TYPE_V2: zwraca tabelę z liczbą miejsc i przykładowymi identyfikatorami miejsc, podzieloną według typu miejsca. Podobnie jak w przypadku funkcji PLACES_COUNT_V2, ta funkcja przyjmuje parametr tabeli, aby przetwarzać jednocześnie wiele lokalizacji wejściowych. Ta architektura obsługuje wydajne przetwarzanie wsadowe i zapewnia zoptymalizowane łączenie geoprzestrzenne w porównaniu z PLACES_COUNT_PER_TYPE.
• PLACES_COUNT_PER_H3 Zwraca tabelę BigQuery z liczbą miejsc w każdej komórce H3.
• PLACES_COUNT: zwraca jeden wiersz zawierający liczbę miejsc.
• PLACES_COUNT_PER_TYPE: zwraca tabelę BigQuery z liczbą miejsc według typu.
• PLACES_COUNT_PER_GEO: zwraca tabelę BigQuery z liczbą miejsc w poszczególnych regionach geograficznych.

Oprócz liczby miejsc wszystkie funkcje z wyjątkiem PLACES_COUNT zwracają też maksymalnie 250 identyfikatorów miejsc na element odpowiedzi.

Identyfikatory miejsc można stosować w przypadku:

• Places API (nowość)
• Geocoding API
• Places UI Kit

Pisanie zapytań z użyciem funkcji

Aby wywołać funkcje, użyj tego formatu: [project name (optional)].[table name].[function name].

Jeśli podczas konfigurowania Statystyk miejsc zmienisz nazwę połączonego zbioru danych, użyj własnej nazwy zamiast domyślnych nazw tabel wymienionych w Funkcjach zliczania miejsc referencyjnych w BigQuery. Możesz też opcjonalnie podać nazwę projektu. Jeśli nie podasz projektu, zapytanie zostanie domyślnie uruchomione w aktywnym projekcie.

Na przykład:

PROJECT_NAME.places_insights___us.PLACES_COUNT

Użyj znaku  JSON_OBJECT , aby przekazać argumenty do funkcji.

Filtrowanie wyników

Funkcje zliczania miejsc obsługują wiele filtrów, które pozwalają zawęzić wyszukiwanie. W tych parametrach (np. price_level lub types) rozróżniana jest wielkość liter, więc muszą one dokładnie odpowiadać nazwom parametrów. Pełną listę opcji znajdziesz w dokumentacji parametrów filtra.

W następnym przykładzie zastosujesz filtry, aby ograniczyć wyszukiwanie według minimalnej oceny użytkownika, poziomu cen, stanu firmy i tego, czy restauracja akceptuje psy, za pomocą funkcji PLACES_COUNT_V2.

Najpierw użyj tabeli geograficznej lub przygotuj tabelę z wybranymi lokalizacjami:

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

Następnie wywołaj funkcję PLACES_COUNT_V2 z tabelą i obiektem JSON zawierającym filtry. Promień wyszukiwania jest uwzględniony w filtrach JSON i będzie stosowany wokół każdego punktu w tabeli my_search_areas.

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

Przykład funkcji Places Count

W tym przykładzie używamy funkcji PLACES_COUNT_V2 z tabelą niestandardowych danych wejściowych my_search_area, aby zwrócić liczbę działających restauracji w promieniu 1000 metrów od Empire State Building i Times Square w Nowym Jorku:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
);

Odpowiedź to tabela BigQuery, która zawiera geo_id, lokalizację geograficzną, liczbę i próbkę identyfikatorów miejsc.

Poniższy przykład pokazuje, jak użyć funkcji PLACES_COUNT_V2 do filtrowania według określonych identyfikatorów marek. W tym przykładzie filtrujemy lokalizacje Starbucks za pomocą identyfikatora marki "1413758728321880760".

Aby znaleźć identyfikatory marek, według których chcesz filtrować, wyślij zapytanie do tabeli brands w swoim zbiorze danych (np. places_insights___us.brands). Więcej informacji o zbiorze danych marek znajdziesz w artykule Pisanie zapytania z użyciem danych o markach.

Aby na przykład znaleźć identyfikator marki „Starbucks”:

SELECT id, name
FROM `PROJECT_NAME.places_insights___us.brands`
WHERE name = "Starbucks"

Po uzyskaniu identyfikatorów marek możesz użyć ich w filtrze brand_ids, jak pokazano w tym zapytaniu:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'brand_ids', ["1413758728321880760"]
      )
);

Wizualizacja wyników

Narzędzia do analizy i analityki biznesowej mają kluczowe znaczenie w odkrywaniu statystyk na podstawie danych z BigQuery. BigQuery obsługuje kilka narzędzi do wizualizacji danych Google i innych firm, których możesz używać do analizowania wyników funkcji na podstawie danych Places Insights.

Przykład wizualizacji wyników funkcji znajdziesz w sekcji Wizualizacja wyników. Więcej informacji i przykład wizualizacji wyników Places Insights znajdziesz w artykule Wizualizacja wyników zapytań.

Ograniczenia i wymagania

Funkcje zliczania miejsc mają następujące ograniczenia i wymagania:

• Obsługiwane są tylko statystyki COUNT.
• Wymagany jest minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m²).
• Limit rozmiaru danych wejściowych parametru: obiekt JSON przekazywany jako parametr do funkcji jest ograniczony do 1 MB. Wpływ tego limitu zależy od wersji funkcji:
• W przypadku funkcji V2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2) ten limit dotyczy tylko obiektu JSON filtrów. Ponieważ dane geograficzne są podawane osobno za pomocą parametru tabeli, te funkcje mogą być skalowane do znacznie większej liczby danych geograficznych bez osiągania limitu rozmiaru JSON.
  • W przypadku parametrów PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE i PLACES_COUNT_PER_GEO ten limit dotyczy całego obiektu JSON, w tym wszystkich definicji geograficznych. Może to ograniczyć liczbę regionów, które można przetworzyć w ramach jednego wywołania.
• Brak obsługi filtrowania według identyfikatora miejsca, opcji ładowania pojazdów elektrycznych lub komponentu adresu.
• Funkcje zliczania miejsc są dostępne tylko w przypadku miast i krajów, w których masz subskrypcję. Informacje o dostępie do zbioru danych znajdziesz w artykule Konfigurowanie Statystyk miejsc.
• W parametrach filtra (np. geography lub types) wielkość liter ma znaczenie i muszą one dokładnie odpowiadać nazwom parametrów, w przeciwnym razie zapytanie się nie powiedzie.

Odwoływanie się do funkcji Reference Places Count w BigQuery

Wszystkie miasta w przykładowym zbiorze danych i kraje w pełnym zbiorze danych obsługują funkcje zliczania miejsc.

Masz dostęp do funkcji Places Count odpowiadających subskrybowanym przez Ciebie zbiorom danych miast i krajów. Informacje o dostępie do zbioru danych znajdziesz w artykule Konfigurowanie Places Insights.

W tabelach podano dostępne miasta, kraje i odpowiadające im nazwy tabel.

Przykładowe dane

Pełne dane