이전 가이드

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

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

  • 데이터 클린룸에서 BigQuery 데이터 교환 목록으로 Places Insights 데이터 세트를 이동합니다.

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

목록으로 이전

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

특정 리전에서 Places Insights를 구독하려면 BigQuery 공유에서 새 목록을 구독해야 합니다. 새 목록을 구독한 후에는 SQL 쿼리를 수정할 필요가 없습니다. 이전과 동일하게 작동합니다.

  • 신규 사용자: Places Insights의 신규 사용자인 경우 Places Insights 설정을 참고하여 목록에 액세스할 수 있도록 개발 환경을 구성하세요.

  • 기존 사용자: 아래 단계에 따라 목록을 사용하도록 이전하세요.

이전 단계

목록으로 이전하려면 다음 단계를 따르세요.

  1. 선택한 도시 및 국가의 목록을 구독합니다. 자세한 내용은 Places Insights 설정을 참고하세요.

  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 형식의 모든 필드에 적용됩니다.

새 필드를 사용하는 예

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