이전 가이드

중요: 이 가이드는 초기 미리보기 출시에서 이전하는 사용자를 대상으로 합니다. 다른 모든 사용자는 이미 등록정보를 사용하고 있으므로 이전할 필요가 없습니다.

2025년 9월 4일 출시된 Places Insights에는 초기 출시 버전에서 다음과 같은 변경사항이 포함되어 있습니다.

• 원하는 BigQuery 위치에서 Places Insights를 구독하는 기능을 지원합니다.

• Places Insights 데이터 세트를 데이터 클린룸에서 BigQuery 데이터 익스체인지 등록정보로 이동합니다.

• 데이터 세트 스키마의 주소 필드는 id 및 name 필드를 별도의 문자열 또는 문자열 배열 필드로 분리합니다.

참고: 새 주소 필드를 활용하려면 등록정보로 이전해야 합니다. 목록으로 마이그레이션하지 않고 데이터 클린룸을 계속 사용하기로 결정한 경우 초기 출시의 주소 필드와 데이터 세트 스키마를 계속 사용하세요.

목록으로 이전

Places Insights의 초기 미리보기 버전에서는 BigQuery 데이터 클린룸에 데이터를 배포했습니다. 2025년 9월 4일 출시를 통해 특정 BigQuery 리전에서 데이터 세트를 구독할 수 있도록 데이터 세트를 BigQuery 목록으로 이동했습니다. 이 변경사항은 제품 기능 및 Places Insights의 유용성에 영향을 미치지 않습니다.

특정 지역의 장소 통계에 가입하려면 BigQuery 공유에서 새 등록정보에 가입해야 합니다. 새 등록정보를 구독한 후에는 SQL 쿼리를 수정하지 않아도 됩니다. 기능은 동일하게 작동합니다.

• 신규 사용자: Places Insights를 처음 사용하는 경우 Places Insights 설정의 단계에 따라 등록정보에 액세스할 수 있도록 개발 환경을 구성하세요.

• 기존 사용자: 목록을 사용하도록 마이그레이션하려면 다음 단계를 따르세요.

참고: 기존 고객의 경우 미리보기 중에 등록정보로 이전하지 않아도 됩니다. 하지만 Places Insights가 GA로 전환되면 등록정보만 지원됩니다.

이전 단계

등록정보로 이전하려면 다음 단계를 따르세요.

1. 선택한 도시와 국가의 등록정보를 구독합니다. 자세한 내용은 장소 통계 설정하기를 참고하세요.

   참고: 장소 통계를 설정할 때 자체 이름 지정 규칙을 사용하도록 데이터 세트 이름을 설정하세요. 기본 데이터 세트 이름을 그대로 두면 기존 데이터 클린룸의 이름과 충돌합니다.

2. 쿼리 또는 함수에서 데이터 세트 이름을 위에서 선택한 데이터 세트 이름으로 업데이트합니다.

3. 이전에 함수를 사용한 경우 데이터 클린룸(maps-platform-analytics-hub)과 함께 사용된 프로젝트 이름을 삭제합니다.

4. 기존 쿼리 또는 함수를 수정하여 프로젝트 이름(선택사항)과 새 주소 필드를 포함합니다.

등록정보를 참조할 때 프로젝트 이름 포함 (선택사항)

등록정보를 사용하면 쿼리에 프로젝트 이름을 포함할 수 있습니다. 프로젝트 이름을 지정하지 않으면 쿼리가 기본적으로 활성 프로젝트로 설정됩니다.

서로 다른 프로젝트에 이름이 동일한 데이터 세트를 연결했거나 활성 프로젝트 외부에서 테이블을 쿼리하는 경우 프로젝트 이름을 포함하는 것이 좋습니다.

프로젝트 및 데이터 세트 이름이 포함된 업데이트된 쿼리의 예

이 쿼리에는 프로젝트 이름이 포함되어 있으며 my_dataset_name 데이터 세트 이름을 사용합니다.

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

새 주소 필드로 이전

Places Insights의 초기 출시에서 데이터 세트 스키마는 id 및 name 하위 필드가 포함된 STRUCT 또는 RECORD로 주소 필드를 나타냈습니다. 이번 출시에서는 스키마를 평면화하여 id 및 name의 별도 최상위 필드를 정의합니다. 새 필드는 문자열 또는 문자열 배열 필드입니다.

참고: 새 주소 필드를 사용하려면 데이터 클린룸에서 등록정보로 이전해야 합니다. 등록정보로 이전하지 않기로 결정한 경우 초기 출시의 주소 필드를 계속 사용하세요.

예를 들어 초기 출시의 지역 주소 구성요소 스키마는 다음과 같습니다.

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

이번 출시에서는 데이터 세트에 이제 두 개의 최상위 문자열 배열 필드가 포함됩니다. 예를 들어 업데이트된 지역 데이터 스키마는 아래와 같습니다.

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

전체 스키마 참조를 확인하세요.

참고: 일부 국가에서는 일부 필드를 사용할 수 없습니다. 거주 국가에서 사용할 수 있는 필드의 구체적인 목록은 국가별 스키마 참조를 참고하세요.

배열이 아닌 필드

이 버전에서는 id 및 name 필드가 이제 비배열 주소 필드의 최상위 STRING 필드입니다.

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

이 새로운 형식은 N이 1~7인 administrative_area_level_N 형식의 모든 필드에 적용됩니다.

참고: 일부 국가에서는 일부 administrative_area_level_N 필드를 사용할 수 없습니다. 해당 국가에서 사용할 수 있는 필드의 구체적인 목록은 국가별 스키마 참조를 참고하세요.

새 필드를 사용하는 예

Places Insights의 초기 출시에서는 WHERE 절에서 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";

새 필드를 사용하여 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";