Przewodnik po migracji

Ważne: ten przewodnik jest przeznaczony dla użytkowników, którzy przechodzą z pierwszej wersji podglądowej. Wszyscy pozostali użytkownicy korzystają już z informacji i nie muszą ich przenosić.

Wersja Places Insights z 4 września 2025 r. zawiera te zmiany w porównaniu z pierwszą wersją:

• Umożliwia subskrybowanie Statystyk miejsc w wybranej lokalizacji BigQuery.

• Przenosi zbiory danych Statystyk miejsc z usług data clean room do ofert wymiany danych BigQuery.

• Pola adresu w schemacie zbioru danych rozdzielają pola id i name na osobne pola ciągu znaków lub tablicy ciągów znaków.

Uwaga: aby korzystać z nowych pól adresu, musisz przejść na wizytówki. Jeśli zdecydujesz się nie przechodzić na listę i zamiast tego nadal korzystać z platformy danych, używaj pól adresu i schematu zbioru danych z pierwszej wersji.

Przenoszenie do informacji

W pierwszej wersji podglądowej Statystyk miejsc dane były wdrażane w usługach data clean room w BigQuery. 4 września 2025 r. przenieśliśmy zbiory danych do wykazów BigQuery, aby umożliwić Ci subskrybowanie zbioru danych w określonym regionie BigQuery. Ta zmiana nie ma wpływu na funkcje usługi Places Insights ani na jej użyteczność.

Aby subskrybować statystyki dotyczące miejsc w określonym regionie, musisz subskrybować nowe informacje o firmach w ramach udostępniania danych w BigQuery. Po zasubskrybowaniu nowych list nie musisz modyfikować zapytań SQL. Będą one nadal działać w ten sam sposób.

• Nowi użytkownicy: jeśli jesteś nowym użytkownikiem statystyk Miejsc Google, wykonaj czynności opisane w artykule Konfigurowanie statystyk Miejsc Google, aby skonfigurować środowisko deweloperskie pod kątem dostępu do informacji.

• Obecni użytkownicy: aby przejść na korzystanie z informacji o produktach, wykonaj czynności opisane poniżej.

Uwaga: jeśli jesteś obecnym klientem, nie musisz przeprowadzać migracji na reklamy produktów podczas wersji podglądowej. Gdy jednak Places Insights zostanie udostępniona ogólnie, będzie obsługiwać tylko wizytówki.

Etapy migracji

Aby przejść na informacje o produktach:

1. Subskrybuj informacje o wybranym mieście i kraju. Instrukcje znajdziesz w artykule Konfigurowanie Statystyk Miejsc.

   Uwaga: gdy konfigurujesz Statystyki miejsc, ustaw nazwę zbioru danych, aby używać własnej konwencji nazewnictwa. Jeśli pozostawisz domyślną nazwę zbioru danych, będzie ona powodować konflikt z nazwą starszej wersji usługi data clean room.

2. Zaktualizuj nazwę zbioru danych w zapytaniach lub funkcjach, aby odpowiadała nazwie zbioru danych wybranej powyżej.

3. Jeśli wcześniej używasz funkcji, usuń nazwę projektu używaną w przypadku platform danych o ograniczonym dostępie (maps-platform-analytics-hub).

4. Zmodyfikuj dotychczasowe zapytania lub funkcje, aby uwzględnić nazwę projektu (opcjonalnie) i nowe pola adresu.

Podaj nazwę projektu, gdy odwołujesz się do informacji (opcjonalnie)

W przypadku informacji możesz uwzględnić w zapytaniu nazwę projektu. Jeśli nie podasz nazwy projektu, zapytanie zostanie domyślnie wykonane w aktywnym projekcie.

Możesz uwzględnić nazwę projektu, jeśli masz połączone zbiory danych o tej samej nazwie w różnych projektach lub jeśli wysyłasz zapytanie do tabeli spoza aktywnego projektu.

Przykład zaktualizowanego zapytania z nazwą projektu i zbioru danych

To zapytanie zawiera nazwę projektu i używa nazwy zbioru danych my_dataset_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

Przenoszenie do nowych pól adresu

W pierwszej wersji Places Insights schemat zbioru danych przedstawiał pole adresu jako STRUCT lub RECORD zawierające pola podrzędne id i name. W tej wersji schemat został spłaszczony, aby zdefiniować oddzielne pola najwyższego poziomu dla id i name. Nowe pola są polami ciągów znaków lub tablic ciągów znaków.

Uwaga: aby korzystać z nowych pól adresu, musisz przenieść dane z czystych pomieszczeń danych do informacji o firmie. Jeśli zdecydujesz się nie migrować do informacji, nadal korzystaj z pól adresu z pierwszej wersji.

Na przykład schemat komponentu adresu lokalizacji w pierwszej wersji wygląda tak:

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

W tej wersji zbiór danych zawiera teraz 2 pola tablicy ciągów znaków najwyższego poziomu. Na przykład zaktualizowany schemat danych o lokalizacji wygląda tak:

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

Zobacz pełny schemat.

Uwaga: nie wszystkie pola są dostępne w każdym kraju. Szczegółową listę pól dostępnych w Twoim kraju znajdziesz w dokumentacji schematu dla poszczególnych krajów.

Pola niebędące tablicami

W tej wersji pola id i name są teraz polami najwyższego poziomu STRING w przypadku pól adresu, które nie są tablicami:

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

Ten nowy format dotyczy wszystkich pól w formularzu administrative_area_level_N, gdzie N = 1–7.

Uwaga: nie wszystkie pola administrative_area_level_N są dostępne w każdym kraju. Szczegółową listę pól dostępnych w Twoim kraju znajdziesz w dokumentacji schematu dotyczącego poszczególnych krajów.

Przykład użycia nowych pól

W pierwszej wersji statystyk miejsc używałeś pola administrative_area_level_1.name w klauzuli WHERE do filtrowania wyników:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

W przypadku nowych pól zapytanie tworzy się za pomocą pola administrative_area_level_1_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";