Migrationsanleitung

Wichtig: Diese Anleitung richtet sich an Nutzer, die von der ersten Preview Version migrieren. Alle anderen Nutzer verwenden bereits Einträge und müssen nicht migrieren.

Diese Version von Places Insights vom 4. September 2025 enthält die folgenden Änderungen gegenüber der ersten Version:

• Sie können Places Insights jetzt im BigQuery Standort Ihrer Wahl abonnieren.

• Die Places Insights-Datasets werden von Data-Clean-Rooms zu BigQuery-Daten austausch einträgen verschoben.

• In den Adressfeldern des Dataset-Schemas werden die Felder id und name in separate Felder für Strings oder String-Arrays unterteilt.

Hinweis: Wenn Sie die neuen Adressfelder nutzen möchten, müssen Sie zu Einträgen migrieren. Wenn Sie nicht zu Einträgen migrieren und stattdessen weiterhin die Data-Clean-Rooms verwenden möchten, nutzen Sie die Adressfelder und das Dataset-Schema aus der ersten Version.

Zu Einträgen migrieren

In der ersten Preview-Version von Places Insights wurden Daten in BigQuery Data-Clean-Rooms bereitgestellt. Mit der Version vom 4. September 2025 haben wir die Datasets zu BigQuery Einträgen verschoben, damit Sie das Dataset in einer bestimmten BigQuery Regionabonnieren können. Diese Änderung hat keine Auswirkungen auf die Produktfunktionen und die Nutzerfreundlichkeit von Places Insights.

Wenn Sie Places Insights in einer bestimmten Region abonnieren möchten, müssen Sie die neuen Einträge in BigQuery Sharing abonnieren. Nachdem Sie die neuen Einträge abonniert haben, müssen Sie Ihre SQL-Abfragen nicht ändern. Sie funktionieren weiterhin wie bisher.

• Neue Nutzer:Wenn Sie Places Insights zum ersten Mal verwenden, folgen Sie der Anleitung unter Places Insights einrichten, um Ihre Entwicklungsumgebung für den Zugriff auf die Einträge zu konfigurieren.

• Bestandskunden:Folgen Sie der Anleitung unten, um zu Einträgen zu migrieren.

Hinweis: Wenn Sie bereits Kunde sind, müssen Sie während der Preview nicht zu Einträgen migrieren. Wenn Places Insights jedoch allgemein verfügbar ist, werden nur Einträge unterstützt.

Migrationsschritte

So migrieren Sie zu Einträgen:

1. Abonnieren Sie die Einträge für die gewünschte Stadt und das gewünschte Land. Eine Anleitung finden Sie unter Places Insights einrichten.

   Hinweis: Wenn Sie Places Insights einrichten, legen Sie den Dataset-Namen so fest, dass Ihre eigene Namenskonvention verwendet wird. Wenn Sie den Standard-Dataset-Namen beibehalten, kommt es zu einem Konflikt mit dem Namen des alten Data-Clean-Rooms.

2. Aktualisieren Sie den Dataset-Namen in Ihren Abfragen oder Funktionen auf den oben ausgewählten Dataset-Namen.

3. Wenn Sie zuvor Funktionenverwendet haben, entfernen Sie den Projektnamen, der mit Data-Clean-Rooms verwendet wurde (maps-platform-analytics-hub).

4. Ändern Sie Ihre vorhandenen Abfragen oder Funktionen so, dass sie Ihren Projektnamen (optional) und die neuen Adressfelder enthalten.

Projektnamen beim Verweisen auf den Eintrag angeben (optional)

Bei Einträgen können Sie den Projektnamen in die Abfrage einfügen. Wenn Sie keinen Projektnamen angeben, wird standardmäßig das aktive Projekt verwendet.

Es kann sinnvoll sein, den Projektnamen anzugeben, wenn Sie verknüpfte Datasets mit demselben Namen in verschiedenen Projekten haben oder wenn Sie eine Tabelle außerhalb des aktiven Projekts abfragen.

Beispiel für eine aktualisierte Abfrage mit Projekt- und Dataset-Namen

Diese Abfrage enthält einen Projektnamen und verwendet den Dataset-Namen my_dataset_name:

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

Zu den neuen Adressfeldern migrieren

In der ersten Version von Places Insights wurde ein Adressfeld im Dataset-Schema als STRUCT oder RECORD dargestellt, das ein Unterfeld id und name enthielt. In dieser Version wird das Schema vereinfacht, um separate Felder der obersten Ebene für id und name zu definieren. Die neuen Felder sind entweder Felder für Strings oder String-Arrays.

Hinweis: Wenn Sie die neuen Adressfelder nutzen möchten, müssen Sie von Data- Clean-Rooms zu Einträgen migrieren. Wenn Sie nicht zu Einträgen migrieren, verwenden Sie weiterhin die Adressfelder aus der ersten Version.

Das Schema für die Adresskomponente „locality“ (Ort) für die erste Version sieht beispielsweise so aus:

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

In dieser Version enthält das Dataset jetzt zwei Felder für String-Arrays der obersten Ebene. Das aktualisierte Datenschema für den Ort sieht beispielsweise so aus:

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

Vollständige Schemareferenz.

Hinweis: Nicht alle Felder sind in allen Ländern verfügbar. Eine Liste der für Ihr Land verfügbaren Felder finden Sie in der länderspezifischen Schemareferenz.

Felder, die keine Arrays sind

In dieser Version sind die Felder id und name jetzt STRING-Felder der obersten Ebene für Adressfelder, die keine Arrays sind:

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

Dieses neue Format gilt für alle Felder im Format administrative_area_level_N, wobei N eine Zahl zwischen 1 und 7 ist.

Hinweis: Nicht alle Felder vom Typ administrative_area_level_N sind in allen Ländern verfügbar. Eine Liste der für Ihr Land verfügbaren Felder finden Sie in der länderspezifischen Schemareferenz.

Beispiel für die Verwendung neuer Felder

In der ersten Version von Places Insights wurde das Feld administrative_area_level_1.name in einer WHERE-Klausel verwendet, um die Ergebnisse zu filtern:

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

Mit den neuen Feldern schreiben Sie die Abfrage mit dem Feld 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";