Guía de migración

Importante: Esta guía está dirigida a los usuarios que migran desde la versión preliminar inicial. Todos los demás usuarios ya utilizan fichas y no necesitan migrar.

En esta versión de Estadísticas de Lugares del 4 de septiembre de 2025, se incluyen los siguientes cambios con respecto a la versión inicial:

• Permite suscribirse a Places Insights en la ubicación de BigQuery que elijas.

• Se trasladan los conjuntos de datos de Places Insights de las salas limpias de datos a las publicaciones del intercambio de datos de BigQuery.

• Los campos de dirección en el esquema del conjunto de datos separan los campos id y name en campos discretos de cadena o de array de cadenas.

Nota: Para aprovechar los nuevos campos de dirección, debes migrar a las fichas. Si decides no migrar a las fichas y, en cambio, seguir usando las salas de datos protegidas, continúa usando los campos de dirección y el esquema del conjunto de datos de la versión inicial.

Migra a fichas

Es la versión preliminar inicial de los datos implementados de Places Insights en las salas limpias de datos de BigQuery. Con el lanzamiento del 4 de septiembre de 2025, trasladamos los conjuntos de datos a las fichas de BigQuery para que puedas suscribirte al conjunto de datos en una región de BigQuery específica. Este cambio no afecta las funciones del producto ni la usabilidad de Places Insights.

Para suscribirte a Places Insights en una región específica, deberás suscribirte a las fichas nuevas en BigQuery Sharing. Una vez que te suscribas a las fichas nuevas, no será necesario que modifiques tus consultas de SQL. Seguirán funcionando de la misma manera.

• Usuarios nuevos: Si eres un usuario nuevo de Estadísticas de Lugares, sigue los pasos que se indican en Configura Estadísticas de Lugares para configurar tu entorno de desarrollo y acceder a las fichas.

• Usuarios existentes: Sigue los pasos que se indican a continuación para migrar y usar fichas

Nota: Si ya eres cliente, no es necesario que migres a las fichas durante la versión preliminar. Sin embargo, cuando Places Insights alcance la DA, solo admitirá fichas.

Pasos de la migración

Para migrar a las fichas, debes hacer lo siguiente:

1. Suscríbete a las fichas de la ciudad y el país que elegiste. Para obtener instrucciones, consulta Configura Places Insights.

   Nota: Cuando configures Places Insights, establece el nombre del conjunto de datos para usar tu propia convención de nomenclatura. Si dejas el nombre predeterminado del conjunto de datos, este entrará en conflicto con el nombre de la sala limpia de datos heredada.

2. Actualiza el nombre del conjunto de datos en tus consultas o funciones al nombre del conjunto de datos que elegiste anteriormente.

3. Si antes usabas funciones, quita el nombre del proyecto que usabas con las salas limpias de datos (maps-platform-analytics-hub).

4. Modifica tus consultas o funciones existentes para incluir el nombre de tu proyecto (opcional) y los nuevos campos de dirección.

Incluye el nombre de tu proyecto cuando hagas referencia a la ficha (opcional).

Con las fichas, puedes incluir el nombre de tu proyecto en la búsqueda. Si no especificas un nombre de proyecto, tu consulta se establecerá de forma predeterminada en el proyecto activo.

Es posible que desees incluir el nombre de tu proyecto si vinculaste conjuntos de datos con el mismo nombre en diferentes proyectos o si consultas una tabla fuera del proyecto activo.

Ejemplo de consulta actualizada con el nombre del proyecto y del conjunto de datos

Esta consulta incluye un nombre de proyecto y usa el nombre del conjunto de datos my_dataset_name:

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

Migra a los nuevos campos de dirección

En la versión inicial de Places Insights, el esquema del conjunto de datos representaba un campo de dirección como un STRUCT o un RECORD que contenía un subcampo id y name. En esta versión, se aplana el esquema para definir campos separados de nivel superior para id y name. Los campos nuevos son campos de cadena o de matriz de cadenas.

Nota: Para aprovechar los nuevos campos de dirección, debes migrar de las salas de datos a las fichas. Si decides no migrar a las fichas, sigue usando los campos de dirección de la versión inicial.

Por ejemplo, a continuación, se muestra el esquema del componente de dirección de localidad para la versión inicial:

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

En esta versión, el conjunto de datos ahora contiene dos campos de array de cadenas de nivel superior. Por ejemplo, a continuación, se muestra el esquema de datos de localidad actualizado:

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

Consulta la referencia del esquema completa.

Nota: No todos los campos están disponibles en todos los países. Para obtener la lista específica de los campos disponibles en tu país, consulta la referencia del esquema específico del país.

Campos que no son de array

En esta versión, los campos id y name ahora son campos STRING de nivel superior para los campos de dirección que no son de array:

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

Este nuevo formato se aplica a todos los campos del formulario administrative_area_level_N, donde N es del 1 al 7.

Nota: No todos los campos de administrative_area_level_N están disponibles en todos los países. Para obtener la lista específica de campos disponibles en tu país, consulta la referencia del esquema específico del país.

Ejemplo con campos nuevos

En la versión inicial de Estadísticas de Lugares, usaste el campo administrative_area_level_1.name en una cláusula WHERE para filtrar los resultados:

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

Con los campos nuevos, escribes la consulta con el campo 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";