Wysyłanie zapytań do zbioru danych za pomocą funkcji zliczania miejsc

Funkcje zliczania miejsc to predefiniowane zapytania SQL, które są uruchamiane w BigQuery i uzupełniają bezpośrednie zapytania dotyczące zbioru 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 wymuszają minimalny obszar wyszukiwania:

• Zapytania dotyczące zbiorów danych o miejscach mogą zwracać tylko liczby 5 i większe, ale nie mają ograniczeń co do wielkości obszaru wyszukiwania.
• Funkcje liczby 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.

Funkcje liczby miejsc mogą być przydatne, jeśli chcesz wiedzieć, kiedy zapytanie nie zwraca żadnych wyników, lub gdy potrzebujesz informacji o małej liczbie miejsc (poniżej 5). Jest to też przydatne, jeśli chcesz uzyskać informacje o poszczególnych miejscach, aby sprawdzić wyniki.

Funkcje zliczania miejsc podają tylko liczby, więc jeśli chcesz wykonywać bardziej złożone zapytania, np. łączyć dane, lub uzyskiwać dodatkowe statystyki, np. średnią ocenę grupy miejsc, wykonaj zapytanie bezpośrednio w zbiorze danych.

Obsługiwane funkcje zliczania miejsc i kraje

Places Insights obsługuje te funkcje:

• 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 obszarach geograficznych.
• PLACES_COUNT_PER_H3 Zwraca tabelę BigQuery z liczbą miejsc w każdej komórce H3.

Oprócz liczby miejsc funkcje PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO i PLACES_COUNT_PER_H3 zwracają też maksymalnie 250 identyfikatorów miejsc w każdym elemencie odpowiedzi. Zobacz wszystkie parametry filtra

Identyfikatory miejsc można stosować w przypadku:

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

Uwaga: funkcje zliczania miejsc możesz stosować w przypadku tych samych miast i krajów, w których masz

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 Places Insights zmienisz nazwę połączonego zbioru danych, użyj własnej nazwy zamiast domyślnych nazw tabel wymienionych tutaj. Możesz też opcjonalnie podać nazwę projektu. Jeśli nie zostanie podany, zapytanie zostanie domyślnie skierowane do aktywnego projektu.

Na przykład:

PROJECT_NAME.places_insights___us.PLACES_COUNT

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

Uwaga: gdy używasz funkcji zliczania miejsc, funkcja jest określana w klauzuli FROM, a klauzula WITH_AGGREGATION_THRESHOLD jest pomijana.

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:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Uwaga: dodaj filtr business_status, aby uzyskać liczbę OPERATIONAL firm. W przeciwnym razie liczba obejmuje zamknięte firmy.

Przykład funkcji zliczania miejsc

W tym przykładzie użyto funkcji PLACES_COUNT, aby zwrócić liczbę działających restauracji w promieniu 1000 metrów od Empire State Building w Nowym Jorku:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

Odpowiedź zawiera jedną liczbę:

W tym przykładzie użyto funkcji BigQuery ST_GEOGPOINT do zwrócenia wartości GEOGRAPHY z punktu, a następnie przekazania tej wartości do parametru geography. Przekazuje też promień wyszukiwania wokół punktu i typ miejsca, "restaurant", do wyszukania.

Uwaga: wymagane i opcjonalne parametry różnią się w przypadku poszczególnych funkcji zliczania miejsc, co opisano w sekcji Filtry.

Liczba miejsc według typu, lokalizacji geograficznej lub komórki H3

Oprócz liczby miejsc funkcje PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO i PLACES_COUNT_PER_H3 zwracają też maksymalnie 250 identyfikatorów miejsc uwzględnionych w odpowiedzi.

Na przykład funkcja PLACES_COUNT_PER_TYPE zwraca tabelę z liczbą miejsc według typu miejsca. Odpowiedź zawiera tablicę identyfikatorów miejsc, które pasują do każdego typu. Zwrócone identyfikatory miejsc możesz wykorzystać do wyszukiwania informacji o poszczególnych miejscach.

Poniższe wywołanie funkcji zwraca liczbę miejsc o tych typach: restaurant, cafe i bar:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Ta funkcja zwraca tabelę z 3 kolumnami: type, count i sample_place_ids. Kolumna count zawiera liczbę miejsc dla każdego type, a kolumna sample_place_ids zawiera maksymalnie 250 identyfikatorów miejsc dla każdego type.

Uwaga: aby uzyskać informacje o miejscu, użyj identyfikatora miejsca do wywołania interfejsu Places API lub zestawu interfejsu Places UI. Przykład znajdziesz w artykule Weryfikowanie danych Places Insights za pomocą przykładowych identyfikatorów miejsc.

Wizualizacja wyników

Narzędzia do analizy i analityki biznesowej są niezbędne, aby pomóc Ci odkrywać statystyki 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ów wizualizacji wyników Places Insights znajdziesz w artykule Wizualizacja wyników zapytania.

Ograniczenia i wymagania

Funkcje liczby miejsc mają te ograniczenia i wymagania:

• Obsługiwane są tylko statystyki COUNT.
• Wymagany jest minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m²).
• Rozmiar danych wejściowych parametru liczby funkcji miejsca jest ograniczony do 1 MB.
• Brak obsługi filtrowania według identyfikatora miejsca, marek, 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 nie zostanie wykonane.