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 usługi Places Insights, aby ocenić jej użyteczność i wartość 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: Sydney (AU), São Paulo (BR), Toronto (CA), Zurych (CH), Berlin (DE), Madryt (ES), Paryż (FR), Londyn (UK), Dżakarta (ID), Bombaj (IN), Rzym (IT), Tokio (JP), Meksyk (MX) i Nowy Jork (US).

Pełne zbiory danych zawierają dane dla każdego obsługiwanego kraju i muszą zostać zakupione. Jeśli chcesz kupić pełny zbiór danych, wypełnij formularz zgłoszeniowy. 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 Places Insights.

Każdy zbiór danych dotyczący danego kraju ma własną listę, którą musisz subskrybować osobno. Więcej informacji o subskrybowaniu wizytówki 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:

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 ogólna marki, np. „Stacja benzynowa”, „Jedzenie i napoje” lub „Obiekty noclegowe”.

Wykonywanie zapytań o dane Statystyk miejsc

Places Insights umożliwia 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, analizy niestandardowej 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 zliczania miejsc: funkcje zliczania miejsc 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, takich jak identyfikatory 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 zawiera co najmniej 5 miejsc. Jeśli na przykład kryteria wyszukiwania zwracają wynik 0, 1, 2, 3 lub 4, wynik ten 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 dotyczące funkcji zliczania miejsc

Funkcje zliczania miejsc 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 minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m2). 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.

Ta tabela zawiera szczegółowe porównanie różnic między zapytaniami bezpośrednimi a funkcjami liczby miejsc.

Funkcje zliczania miejsc Zapytania dotyczące 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. Możesz napisać własne zapytanie SQL, aby uruchomić funkcje agregacji, takie 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 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 liczby miejsc 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.