Guía de migración

Esta versión de Estadísticas de lugares del 4 de septiembre de 2025 incluye los siguientes cambios con respecto a la versión inicial:

Admite la capacidad de suscribirse a Estadísticas de lugares en la ubicación de BigQuery que elijas.
Mueve los conjuntos de datos de Estadísticas de lugares de las salas limpias de datos a las fichas de 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 array de cadenas.

Migra a las fichas

La versión inicial de la versión preliminar de Estadísticas de lugares implementó datos en las salas limpias de datos de BigQuery datos. Con la versión del 4 de septiembre de 2025, movimos los conjuntos de datos a las fichas de BigQuery listings para permitirte suscribirte al conjunto de datos en una región específica de BigQuery region. Este cambio no afecta las funciones del producto ni la usabilidad de Estadísticas de lugares.

Para suscribirte a Estadísticas de lugares en una región específica, deberás suscribirte a las nuevas fichas en BigQuery Sharing. Una vez que te hayas suscrito a las fichas nuevas, no necesitarás modificar 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 para acceder a las fichas.
Usuarios existentes: Sigue los pasos que se indican a continuación para migrar al uso de fichas.

Pasos de la migración

Para migrar a las fichas, debes hacer lo siguiente:

Suscríbete a las fichas de la ciudad y el país que elegiste. Para obtener instrucciones, consulta Configura Estadísticas de lugares.

Nota: Cuando configures Estadísticas de lugares, establece el nombre del conjunto de datos para usar tu propia convención de nombres. Si dejas el nombre predeterminado del conjunto de datos, entrará en conflicto con el nombre de la sala limpia de datos heredada.
Actualiza el nombre del conjunto de datos en tus consultas o funciones al nombre del conjunto de datos que elegiste anteriormente.
Si usaste funciones, quita el nombre del proyecto que se usó con las salas limpias de datos (maps-platform-analytics-hub).
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 consulta. 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 Estadísticas de lugares, el esquema del conjunto de datos representaba un campo de dirección como un STRUCT o 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 array de cadenas.

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

`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, el esquema de datos de localidad actualizado se muestra a continuación:

`locality_ids`	`ARRAY<string>`
`locality_names`	`ARRAY<string>`

Consulta la referencia completa del esquema.

Campos que no son arrays

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 arrays:

`administrative_area_level_1_id`	`STRING`
`administrative_area_level_1_name`	`STRING`

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

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";