Hướng dẫn di chuyển

Bản phát hành Thông tin chi tiết về địa điểm ngày 4 tháng 9 năm 2025 bao gồm những thay đổi sau so với bản phát hành ban đầu:

  • Hỗ trợ khả năng đăng ký Thông tin chi tiết về địa điểm trong vị trí BigQuery mà bạn chọn.

  • Di chuyển tập dữ liệu Thông tin chi tiết về địa điểm từ phòng sạch dữ liệu sang trang thông tin trao đổi dữ liệu BigQuery.

  • Các trường địa chỉ trong giản đồ tập dữ liệu 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 Thông tin chi tiết về địa điểm đã triển khai dữ liệu trong BigQuery phòng sạch dữ liệu. Với bản phát hành ngày 4 tháng 9 năm 2025, chúng tôi đã di chuyển các tập dữ liệu sang trang thông tin BigQuery listings để cho phép bạn đăng ký tập dữ liệu trong 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 Thông tin chi tiết về địa điểm.

Để đăng ký Thông tin chi tiết về địa điểm ở 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ý trang thông tin mới, bạn không cần sửa đổi truy vấn SQL. Các truy vấn này 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 Thông tin chi tiết về địa điểm, hãy làm theo các bước trong Thiết lập Thông tin chi tiết về địa điểm để đị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ý trang thông tin cho 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 Thông tin chi tiết về địa điểm.

  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 đã sử 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ó để đưa vào tên dự án (không bắt buộc) và các trường địa chỉ mới.

Đưa vào tên dự án khi tham chiếu đến trang thông tin (không bắt buộc)

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

Bạn có thể muốn đưa vào 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 đ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 Thông tin chi tiết về địa điểm, 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ỉ địa phương cho 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 hai trường mảng chuỗi ở cấp cao nhất. Ví dụ: giản đồ dữ liệu địa phương đã cập nhật được trình bày bên dưới:

locality_ids ARRAY<string>
locality_names ARRAY<string>

Xem tài liệu tham khảo về giản đồ đầy đủ .

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 ở dạng administrative_area_level_N, trong đó N là từ 1 đến 7.

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

Trong bản phát hành ban đầu của Thông tin chi tiết về địa điểm, bạn đã sử dụng trường administrative_area_level_1.name trong 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 sẽ viết truy vấn bằ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";