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 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 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, 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 Places Count 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, wykonuj zapytania bezpośrednio w zbiorze danych.

Obsługiwane funkcje 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 na element odpowiedzi. Zobacz wszystkie parametry filtra

Identyfikatory miejsc można stosować w przypadku:

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

Uwaga: możesz korzystać z funkcji zliczania miejsc w tych samych miastach i krajach, do których masz dostęp.

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 żadnego 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.

Uwaga: gdy używasz funkcji Places Count, 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. Te parametry (np. price_level lub types) rozróżniają wielkość liter i muszą 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 Places Count

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 wizualizacji wyników Places Insights znajdziesz w artykule Wizualizacja wyników zapytań.

Ograniczenia i wymagania

Funkcje Places Count 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²).
• 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 Liczba miejsc są dostępne tylko w przypadku miast i krajów, do 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.

Funkcje odwoływania się do liczby miejsc 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.

Uwaga: 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 domyślnie będzie dotyczyć aktywnego projektu.

W tabelach znajdziesz listę dostępnych miast i krajów oraz odpowiadające im nazwy tabel.

Przykładowe dane

Miasto, kraj	Nazwy tabel
Sydney, Australia	places_insights___au___sample.FUNCTION_NAME
São Paulo, Brazylia	places_insights___br___sample.FUNCTION_NAME
Toronto, Kanada	places_insights___ca___sample.FUNCTION_NAME
Paryż, Francja	places_insights___fr___sample.FUNCTION_NAME
Berlin, Niemcy	places_insights___de___sample.FUNCTION_NAME
Bombaj, Indie	places_insights___in___sample.FUNCTION_NAME
Dżakarta, Indonezja	places_insights___id___sample.FUNCTION_NAME
Rzym, Włochy	places_insights___it___sample.FUNCTION_NAME
Tokio, Japonia	places_insights___jp___sample.FUNCTION_NAME
Meksyk (miasto), Meksyk	places_insights___mx___sample.FUNCTION_NAME
Madryt, Hiszpania	places_insights___es___sample.FUNCTION_NAME
Zurych, Szwajcaria	places_insights___ch___sample.FUNCTION_NAME
Londyn, Wielka Brytania	places_insights___gb___sample.FUNCTION_NAME
Nowy Jork, Stany Zjednoczone	places_insights___us___sample.FUNCTION_NAME

Pełne dane

Kraj	Nazwy tabel
Australia	places_insights___au.FUNCTION_NAME
Brazylia	places_insights___br.FUNCTION_NAME
Kanada	places_insights___ca.FUNCTION_NAME
Francja	places_insights___fr.FUNCTION_NAME
Niemcy	places_insights___de.FUNCTION_NAME
Indie	places_insights___in.FUNCTION_NAME
Indonezja	places_insights___id.FUNCTION_NAME
Włochy	places_insights___it.FUNCTION_NAME
Japonia	places_insights___jp.FUNCTION_NAME
Meksyk	places_insights___mx.FUNCTION_NAME
Hiszpania	places_insights___es.FUNCTION_NAME
Szwajcaria	places_insights___ch.FUNCTION_NAME
Wielka Brytania	places_insights___gb.FUNCTION_NAME
Stany Zjednoczone	places_insights___us.FUNCTION_NAME