Omówienie funkcji zliczania miejsc

Funkcje zliczania miejsc to kolejny sposób na wysyłanie zapytań dotyczących danych z Miejsc dostępnych w Statystykach miejsc. Są to predefiniowane zapytania SQL, które są uruchamiane w BigQuery i uzupełniają zapytania dotyczące danych o miejscach. Główna różnica polega na tym, że funkcje nie wymuszają minimalnego progu liczby, ale minimalnego obszaru wyszukiwania:

• Zapytania dotyczące zbiorów danych o miejscach mogą zwracać tylko liczby powyżej 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 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). Na przykład możliwość zwracania niskich wartości jest ważna w przypadku zastosowań związanych z wyborem witryn.

Obsługiwane funkcje liczby 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.

Podobnie jak w przypadku zbiorów danych o miejscach, funkcje zliczania miejsc są dostępne dla największego miasta w każdym z obsługiwanych krajów. Na przykład w przypadku Australii możesz uzyskać dostęp do funkcji zliczania miejsc w Sydney.

Uwaga: możesz uzyskać dostęp do funkcji zliczania miejsc w przypadku tych samych miast i krajów, w których masz subskrypcję dostępu do przykładowego zbioru danych.

Pełną listę obsługiwanych miast i krajów znajdziesz w artykule Funkcje zliczania miejsc referencyjnych w BigQuery.

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 `maps-platform-analytics-hub.sample_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;

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

Odpowiedź zawiera jedną liczbę:

W tym przykładzie instrukcja SELECT odwołuje się do funkcji PLACES_COUNT dla Stanów Zjednoczonych, używając składni:

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

Pełną listę obsługiwanych miast i krajów znajdziesz w artykule Funkcje zliczania miejsc referencyjnych w BigQuery.

Użyj znaku  JSON_OBJECT do przekazywania argumentów do funkcji. 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 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 `maps-platform-analytics-hub.sample_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.

Zastosuj filtry do funkcji

Zastosuj filtry, aby zawęzić kryteria wyszukiwania. Funkcje zliczania miejsc obsługują wiele filtrów, które pozwalają zawęzić wyszukiwanie. W kolejnym przykładzie zastosujesz filtry, aby ograniczyć wyszukiwanie według minimalnej oceny użytkowników, poziomu cen, statusu firmy i tego, czy restauracja akceptuje psy:

SELECT `maps-platform-analytics-hub.sample_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;

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

Ograniczenia i wymagania

Funkcje zliczania 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 lub komponentu adresu.

Porównywanie funkcji zliczania miejsc i zapytań dotyczących zbioru danych o miejscach

W tej tabeli wymieniamy najważniejsze różnice:

	Funkcje zliczania miejsc	Zapytania dotyczące zbioru danych o miejscach
Interfejs	4 wstępnie zdefiniowane funkcje SQL, które generują COUNT statystyki: pojedyncza liczba, liczba według typu, liczba według lokalizacji geograficznej, liczba według komórki H3.	Używa SQL do uruchamiania funkcji agregacji, takich jak COUNT, COUNT_IF, SUM i AVG.. Dodatkowe statystyki można generować za pomocą funkcji JOIN, GROUP BY, WHERE i innych.
Ograniczenia	Wymusza minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m^2). Funkcja zwraca wynik nawet wtedy, gdy liczba agregacji jest mniejsza niż 5, o ile spełniony jest minimalny obszar wyszukiwania.	Wymusza próg liczby 5, ale nie określa minimalnego obszaru wyszukiwania.
Obsługiwane filtry atrybutów	Pełny schemat jest obsługiwany z wyjątkiem: Miejsce id Elementy adresu	Pełny schemat jest obsługiwany
Zalety	Może zwrócić dowolną liczbę. Zoptymalizowany pod kątem wydajności i niskich kosztów przetwarzania. Prosta obsługa. Nie musisz pisać skomplikowanych zapytań. Sprawdza parametry wejściowe i zwraca błąd, co ułatwia korzystanie z funkcji i jej debugowanie.	Umożliwia wykonywanie złożonych zapytań, takich jak zaawansowane filtrowanie i łączenie. Nie wymusza minimalnego obszaru wyszukiwania. Obsługuje dodatkowe funkcje agregujące poza COUNT, takie jak AVG, SUM i GROUP BY.

Funkcje liczby miejsc odniesienia w BigQuery

Funkcje liczby miejsc obsługują te miasta i kraje. Musisz zasubskrybować każde miasto i każdy kraj osobno.

Miasto, kraj	Nazwy tabel
Sydney, Australia	maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME
São Paulo, Brazylia	maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME
Toronto, Kanada	maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME
Paryż, Francja	maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME
Berlin, Niemcy	maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME
Londyn, Wielka Brytania	maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME
Bombaj, Indie	maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME
Dżakarta, Indonezja	maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME
Rzym, Włochy	maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME
Tokio, Japonia	maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME
Meksyk (miasto), Meksyk	maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME
Madryt, Hiszpania	maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME
Zurych, Szwajcaria	maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME
Nowy Jork, Stany Zjednoczone	maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME