Hướng dẫn di chuyển

Bản phát hành Places Insights ngày 4 tháng 9 năm 2025 có những thay đổi sau so với bản phát hành ban đầu:

  • Hỗ trợ khả năng đăng ký Places Insights ở vị trí BigQuery mà bạn chọn.

  • Di chuyển các tập dữ liệu Places Insights từ phòng sạch dữ liệu sang các mục trao đổi dữ liệu BigQuery.

  • Các trường địa chỉ trong giản đồ tập dữ liệu sẽ tách các trường id và name thành các trường chuỗi hoặc mảng chuỗi riêng biệt.

Di chuyển sang trang thông tin

Bản phát hành Xem trước ban đầu của Places Insights đã triển khai dữ liệu trong phòng sạch cho dữ liệu của BigQuery. Kể từ bản phát hành ngày 4 tháng 9 năm 2025, chúng tôi đã chuyển các tập dữ liệu sang trang thông tin BigQuery để bạn có thể đăng ký tập dữ liệu ở một khu vực BigQuery cụ thể. Thay đổi này không ảnh hưởng đến các tính năng của sản phẩm và khả năng sử dụng của Thông tin chi tiết về địa điểm.

Để đăng ký Places Insights ở một khu vực cụ thể, bạn cần đăng ký trang thông tin mới trong BigQuery Sharing. Sau khi đăng ký danh sách mới, bạn không cần sửa đổi truy vấn SQL. Chúng vẫn hoạt động như cũ.

  • Người dùng mới: Nếu bạn là người dùng mới của Places Insights, hãy làm theo các bước trong phần Thiết lập Places Insights để định cấu hình môi trường phát triển nhằm truy cập vào trang thông tin.

  • Người dùng hiện tại: Làm theo các bước bên dưới để di chuyển sang sử dụng trang thông tin

Các bước di chuyển

Để di chuyển sang trang thông tin, bạn cần:

  1. Đăng ký nhận thông tin về các địa điểm ở thành phố và quốc gia bạn chọn. Để biết hướng dẫn, hãy xem bài viết Thiết lập Places Insights.

  2. Cập nhật tên tập dữ liệu trong các truy vấn hoặc hàm thành tên tập dữ liệu mà bạn đã chọn ở trên.

  3. Nếu trước đây bạn đã dùng các hàm, hãy xoá tên dự án được dùng với phòng sạch dữ liệu (maps-platform-analytics-hub).

  4. Sửa đổi các truy vấn hoặc hàm hiện có để thêm tên dự án (không bắt buộc) và các trường địa chỉ mới.

Thêm tên dự án khi tham chiếu trang thông tin (không bắt buộc)

Với danh sách, bạn có thể thêm tên dự án vào truy vấn. Nếu bạn không chỉ định tên dự án, truy vấn của bạn sẽ mặc định là dự án đang hoạt động.

Bạn nên thêm tên dự án nếu đã liên kết các tập dữ liệu có cùng tên trong các dự án khác nhau hoặc nếu bạn đang truy vấn một bảng bên ngoài dự án đang hoạt động.

Ví dụ về truy vấn đã cập nhật có tên dự án và tập dữ liệu

Truy vấn này có chứa tên dự án và sử dụng tên tập dữ liệu my_dataset_name:

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

Di chuyển sang các trường địa chỉ mới

Trong bản phát hành ban đầu của Places Insights, giản đồ tập dữ liệu biểu thị một trường địa chỉ dưới dạng STRUCT hoặc RECORD chứa một trường con id và name. Bản phát hành này làm phẳng giản đồ để xác định các trường riêng biệt, cấp cao nhất cho id và name. Các trường mới là trường chuỗi hoặc trường mảng chuỗi.

Ví dụ: giản đồ cho thành phần địa chỉ theo địa phương trong bản phát hành ban đầu được trình bày bên dưới:

locality STRUCT
  locality.id STRING
  locality.name STRING

Trong bản phát hành này, tập dữ liệu hiện chứa 2 trường mảng chuỗi cấp cao nhất. Ví dụ: giản đồ dữ liệu địa phương mới cập nhật được minh hoạ dưới đây:

locality_ids ARRAY<string>
locality_names ARRAY<string>

Xem toàn bộ tài liệu tham khảo về lược đồ.

Các trường không phải là mảng

Trong bản phát hành này, các trường id và name hiện là các trường STRING cấp cao nhất cho các trường địa chỉ không phải là mảng:

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

Định dạng mới này áp dụng cho tất cả các trường trong biểu mẫu administrative_area_level_N, trong đó N là từ 1 đến 7.

Ví dụ sử dụng các trường mới

Trong bản phát hành ban đầu của Places Insights, bạn đã sử dụng trường administrative_area_level_1.name trong một mệnh đề WHERE để lọc kết quả:

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

Với các trường mới, bạn viết truy vấn bằng cách sử dụng trường 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";