Informacje o danych i zapytaniach w Statystykach miejsc

Dane Statystyk miejsc

Statystyki miejsc udostępniają pełne i przykładowe zbiory danych w BigQuery.

Przykładowe zbiory danych mają umożliwić Ci wypróbowanie Statystyk miejsc, aby ocenić użyteczność i wartość usługi przed podjęciem decyzji o zakupie pełnego zbioru danych. Przykładowy zbiór danych zawiera tylko dane dotyczące samego miasta. Nie zawiera danych dotyczących okolicznego obszaru metropolitalnego.

Przykładowa lista zawiera dane dotyczące największego miasta w każdym z obsługiwanych krajów:

Amsterdam (NL)	Helsinki (FI)	Płowdiw (BG)
Ankara (TR)	Hongkong (HK)	Riffa (BH)
Arequipa (PE)	Dżakarta (ID)	Rzym (IT)
Ateny (GR)	Dżudda (SA)	Santiago (CL)
Bad Gastein (AT)	Johannesburg (ZA)	Sao Paulo (BR)
Berlin (DE)	Kuala Lumpur (MY)	Szardża (AE)
Brno (CZ)	Lizbona (PT)	Singapur (SG)
Bruksela (BE)	Londyn (Wielka Brytania)	Sztokholm (SE)
Bukareszt (RO)	Lusail (QA)	Sydney (AU)
Buenos Aires (AR)	Madryt (ES)	Tajpej (TW)
Busan (KR)	Manila (PH)	Tel Awiw-Jafa (IL)
Kair (EG)	Medellín (CO)	Tokio (JP)
Chiang Mai (TH)	Meksyk (MX)	Toronto (Kanada)
Kopenhaga (DK)	Bombaj (IN)	Warszawa (PL)
Cork (IE)	Nowy Jork (Stany Zjednoczone)	Wellington (NZ)
Debreczyn (HU)	Oslo (NO)	Zurych (CH)
Hanoi (VN)	Paryż (FR)

Pełne zbiory danych zawierają dane dla każdego obsługiwanego kraju i muszą zostać zakupione. Jeśli chcesz zarejestrować się w usłudze Places Insights, wypełnij formularz zgłoszenia. Tylko subskrybent danych musi poprosić o dostęp do zbioru danych Statystyki miejsc. Gdy subskrypcja jest aktywna w projekcie BigQuery, każdy użytkownik z dostępem do tego projektu może wysyłać zapytania dotyczące danych Statystyk miejsc.

Każdy zbiór danych dotyczący danego kraju ma własną listę, którą musisz subskrybować osobno. Więcej informacji o subskrybowaniu informacji znajdziesz w artykule Konfigurowanie Statystyk Miejsc.

Schematy zbiorów danych

Schemat zbioru danych o miejscach w każdym kraju składa się z 2 części:

• Schemat podstawowy, który jest wspólny dla zbiorów danych ze wszystkich krajów.
• schemat specyficzny dla danego kraju, który określa komponenty schematu właściwe dla tego kraju;

Jeśli na przykład pracujesz z zestawem danych dla Hiszpanii (ES), odwołuj się zarówno do schematu podstawowego, jak i do schematu specyficznego dla tego kraju.

Schemat zbioru danych o markach definiuje 3 pola:

• id: identyfikator marki.
• name: nazwa marki, np. „Hertz” lub „Chase”.
• category: kategoria najwyższego poziomu marki, np. „Stacja benzynowa”, „Jedzenie i napoje” lub „Obiekty noclegowe”.

Wykonywanie zapytań o dane Statystyk miejsc

Statystyki miejsc umożliwiają wysyłanie zapytań do zbiorów danych na 2 sposoby:

• Bezpośrednie wykonywanie zapytań w zbiorze danych za pomocą SQL: uruchamiaj standardowe zapytania BigQuery SQL w tabelach zbioru danych. Zapewnia to największą elastyczność w przypadku złożonego filtrowania, łączenia z własnymi danymi, analiz niestandardowych i obsługi dodatkowych funkcji agregacji poza COUNT, takich jak AVG, SUM i GROUP BY. Zobacz dokumentację
• Wysyłanie zapytań do zbioru danych za pomocą funkcji Places Count: funkcje Places Count to predefiniowane, zoptymalizowane zapytania SQL, które są uruchamiane bezpośrednio w BigQuery i upraszczają typowe zadania pobierania danych. Umożliwiają one uzyskanie bardziej szczegółowych informacji, np. identyfikatorów miejsc, które pozwalają wyszukiwać szczegóły dotyczące poszczególnych miejsc. Zobacz dokumentację

Zapytania bezpośrednie

Bezpośrednie wysyłanie zapytań o dane wymusza próg agregacji. Wynik jest zwracany tylko wtedy, gdy zapytanie agreguje co najmniej 5 miejsc. Jeśli na przykład kryteria wyszukiwania dają w wyniku liczbę 0, 1, 2, 3 lub 4, wynik jest pomijany w odpowiedzi. Na przykład zapytanie o łączną liczbę restauracji w danym obszarze zwróci odpowiedź tylko wtedy, gdy łączna liczba będzie wynosić co najmniej 5. W przeciwnym razie nie zostanie zwrócona żadna odpowiedź.

Zapytania do funkcji Places Count

Funkcje Places Count mogą zwracać listę identyfikatorów miejsc, których można używać do wyszukiwania informacji o poszczególnych miejscach za pomocą innych usług GMP, takich jak Places API i Places UI Kit.

Funkcje zliczania miejsc nie wymuszają progu agregacji, ale wymuszają minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m²). Oznacza to, że dopóki zapytanie jest większe niż minimalny obszar wyszukiwania, zawsze otrzymasz wynik, nawet jeśli nie ma miejsc pasujących do zapytania.

Kiedy wysyłać zapytania bezpośrednio do danych, a kiedy używać funkcji

Jeśli nie potrzebujesz małej liczby wyników, chcesz uzyskać informacje wykraczające poza liczbę, np. AVG, SUM lub COUNTIF, albo musisz wykonać bardziej złożone zapytania, np. łączenie zbiorów danych, możesz bezpośrednio wysyłać zapytania o dane.

Jeśli chcesz sprawdzić, czy jest mała liczba wyników lub czy nie ma ich wcale, albo jeśli chcesz pobrać informacje o poszczególnych miejscach, takie jak nazwa lub adres, użyj funkcji zapytania.

W tej tabeli znajdziesz szczegółowe porównanie różnic między funkcjami zapytań bezpośrednich a funkcjami zliczania miejsc.

	Funkcje Places Count	Zapytania bezpośrednie do zbioru danych
Zalety	Zwraca identyfikatory miejsc, których można używać do wysyłania zapytań do innych interfejsów API. 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.
Interfejs	Cztery 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. Znak JSON_OBJECT przekazuje argumenty do funkcji.	Napisz własne zapytanie SQL, aby uruchomić funkcje agregacji, takie jak COUNT, COUNT_IF, SUM i AVG.. Dodatkowe statystyki możesz generować za pomocą funkcji JOIN, GROUP BY, WHERE i innych.
Ograniczenia	Wymusza minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m2). Funkcja zwraca wynik nawet wtedy, gdy liczba agregacji jest mniejsza niż 5, o ile spełniony jest minimalny obszar wyszukiwania.	Wyniki z liczbą mniejszą niż 5 są pomijane (tzn. wiersz jest wykluczany).
Obsługiwane filtry atrybutów	Parametry filtra funkcji Places Count są takie same jak filtry atrybutów zapytań bezpośrednich, z wyjątkiem tych: Miejsce id Elementy adresu godziny otwarcia; Opcje ładowania EV Marki	Obsługiwany jest pełny schemat.