Tài liệu tham khảo

Trang này cung cấp hướng dẫn về các bảng BigQuery dùng để huấn luyện mô hình, bao gồm cả giản đồ và nội dung mô tả trường. Bạn cũng sẽ thấy thông tin chi tiết về các khái niệm cốt lõi (ảnh chụp nhanh, tài sản và dữ liệu quan sát) cấu trúc dữ liệu, cùng với thông tin chi tiết về cách sử dụng các bảng khi có liên quan.

Tên bảng có tiền tố là loại sản phẩm (cropped_, full_frame_ hoặc pano_) và chỉ những bảng cho các sản phẩm có trong gói thuê bao của bạn mới xuất hiện trong tập dữ liệu. Các bảng kết thúc bằng _all bao gồm dữ liệu từ tất cả ảnh chụp nhanh và các bảng kết thúc bằng _latest chỉ bao gồm dữ liệu từ ảnh chụp nhanh gần đây nhất.

Các khái niệm chính

• Ảnh chụp nhanh: Bản sao cố định, không thể thay đổi của một tập dữ liệu tại một thời điểm cụ thể.
• Tài sản: Một đối tượng trong thế giới thực, chẳng hạn như biển báo đường bộ hoặc cột điện. Các thành phần này có sẵn cho sản phẩm được cắt và sản phẩm toàn khung hình.
• Quan sát: Bản ghi hình ảnh từ một sự kiện chụp. Đối với các sản phẩm được cắt và toàn khung hình, một quan sát là một phát hiện về một tài sản và chứa siêu dữ liệu cho phát hiện đó, chẳng hạn như thời gian chụp ảnh và vị trí của camera. Đối với sản phẩm toàn cảnh, một quan sát là một khung hình riêng lẻ của ảnh chụp 360 độ và không liên kết với một thành phần.

snapshots

Ảnh chụp nhanh là bản sao cố định, không thể thay đổi của một tập dữ liệu tại một thời điểm cụ thể. Bảng ảnh chụp nhanh cung cấp siêu dữ liệu liên kết với ảnh chụp nhanh, để giúp bạn hiểu rõ trạng thái tạm thời của dữ liệu ở cấp cao.

Tên cột	Loại	Mô tả
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh. Được dùng làm khoá để kết hợp các bảng.
subscription_id	STRING	Giá trị nhận dạng riêng biệt của gói thuê bao.
creation_time	DẤU THỜI GIAN	Dấu thời gian khi bản tổng quan nhanh được tạo. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
product_types	<STRING>	Các loại sản phẩm liên kết với ảnh chụp nhanh. Các giá trị hợp lệ là SV_CROPPED_ASSETS, SV_FULL_FRAME_ASSETS và SV_PANO.

cropped_observations_all

Bảng cropped_observations_all cung cấp thông tin quan sát về thành phần được cắt từ tất cả ảnh chụp nhanh. Bạn có thể sử dụng bảng này để phát hiện sự khác biệt trong các quan sát giữa các ảnh chụp nhanh.

Tên cột	Loại	Mô tả
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản liên kết với thông tin quan sát này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực. Vị trí ghi lại nội dung quan sát.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
observation_id	STRING	Chuỗi xác định duy nhất quan sát.
bbox	STRUCT	Cấu trúc của các cấu trúc chứa toạ độ x/y căn chỉnh hộp giới hạn của thành phần.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập bằng API tĩnh Chế độ xem đường phố của Google Maps.
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí của tài sản.

cropped_assets_all

Bảng cropped_assets_all cung cấp các thành phần được cắt từ tất cả ảnh chụp nhanh. Bạn có thể sử dụng bảng này để phát hiện sự khác biệt về thành phần giữa các ảnh chụp nhanh.

Tên cột	Loại	Mô tả
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập tài sản này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực, thể hiện vị trí ước chừng của tài sản.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.

cropped_observations_latest

Bảng cropped_observations_latest chỉ cung cấp thông tin quan sát về thành phần đã cắt từ ảnh chụp nhanh gần đây nhất.

Tên cột	Loại	Mô tả
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản liên kết với thông tin quan sát này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực. Vị trí ghi lại nội dung quan sát.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
observation_id	STRING	Chuỗi xác định duy nhất quan sát.
bbox	STRUCT	Cấu trúc của các cấu trúc chứa toạ độ x/y căn chỉnh hộp giới hạn của thành phần.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập bằng API tĩnh Chế độ xem đường phố của Google Maps.
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí của tài sản.

cropped_assets_latest

Bảng cropped_assets_latest chỉ cung cấp các thành phần được cắt từ ảnh chụp nhanh gần đây nhất.

Tên cột	Loại	Mô tả
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập tài sản này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực, thể hiện vị trí ước chừng của tài sản.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_all

Bảng full_frame_observations_all cung cấp thông tin quan sát về tài sản toàn khung hình (chưa cắt) từ tất cả ảnh chụp nhanh. Bạn có thể sử dụng bảng này để phát hiện sự khác biệt trong các quan sát giữa các ảnh chụp nhanh.

Tên cột	Loại	Mô tả
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản liên kết với thông tin quan sát này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực. Vị trí ghi lại nội dung quan sát.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
observation_id	STRING	Chuỗi xác định duy nhất quan sát.
bbox	STRUCT	Cấu trúc của các cấu trúc chứa toạ độ x/y căn chỉnh hộp giới hạn của thành phần.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập với API tĩnh Chế độ xem đường phố của Google Maps.
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí của tài sản.

full_frame_assets_all

Bảng full_frame_assets_all cung cấp các thành phần toàn khung hình (không bị cắt) từ tất cả ảnh chụp nhanh. Bạn có thể sử dụng bảng này để phát hiện sự khác biệt về tài sản giữa các ảnh chụp nhanh.

Tên cột	Loại	Mô tả
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập tài sản này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực, thể hiện vị trí ước chừng của tài sản.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_latest

Bảng full_frame_observations_latest cung cấp thông tin quan sát về tài sản toàn khung hình (không bị cắt) chỉ từ ảnh chụp nhanh gần đây nhất.

Tên cột	Loại	Mô tả
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản liên kết với thông tin quan sát này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực. Vị trí ghi lại nội dung quan sát.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
observation_id	STRING	Chuỗi xác định duy nhất quan sát.
bbox	STRUCT	Cấu trúc của các cấu trúc chứa toạ độ x/y căn chỉnh hộp giới hạn của thành phần.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập bằng API tĩnh Chế độ xem đường phố của Google Maps.
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí của tài sản.

full_frame_assets_latest

Bảng full_frame_assets_latest chỉ cung cấp các thành phần toàn khung hình (không bị cắt) từ ảnh chụp nhanh gần đây nhất.

Tên cột	Loại	Mô tả
asset_id	STRING	Giá trị nhận dạng riêng biệt của tài sản.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập tài sản này.
asset_type	STRING	Phân loại chính của thành phần. Các giá trị hợp lệ là ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE và ASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực, thể hiện vị trí ước chừng của tài sản.
detection_time	DẤU THỜI GIAN	capture_time quan sát gần đây nhất cho tài sản đã cho. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.

pano_observations_all

Bảng pano_observations_all cung cấp thông tin quan sát toàn cảnh (toàn bộ cảnh) từ tất cả ảnh chụp nhanh. Không giống như quan sát tài sản, quan sát toàn cảnh chứa siêu dữ liệu máy ảnh ở cấp khung hình và hướng không gian cho các sự kiện chụp 360 độ thay vì phát hiện tài sản được bản địa hoá. Bạn có thể sử dụng bảng này để phát hiện sự khác biệt trong các quan sát toàn cảnh giữa các ảnh chụp nhanh.

Tên cột	Loại	Mô tả
capture_id	STRING	Giá trị nhận dạng riêng biệt đại diện cho một sự kiện chụp ảnh toàn cảnh.
observation_id	STRING	Giá trị nhận dạng riêng biệt cho một khung hình riêng lẻ tạo thành một phân đoạn của ảnh toàn cảnh 360 độ.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
capture_location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực biểu thị tâm của xe khi quan sát được ghi lại.
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí chụp ảnh của quan sát.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập với API tĩnh Chế độ xem đường phố của Google Maps.

pano_observations_latest

Bảng pano_observations_latest chỉ cung cấp thông tin quan sát toàn cảnh (toàn bộ cảnh) từ ảnh chụp nhanh gần đây nhất.

Tên cột	Loại	Mô tả
capture_id	STRING	Giá trị nhận dạng riêng biệt đại diện cho một sự kiện chụp ảnh toàn cảnh.
observation_id	STRING	Giá trị nhận dạng riêng biệt cho một khung hình riêng lẻ tạo thành một phân đoạn của ảnh toàn cảnh 360 độ.
snapshot_id	STRING	Giá trị nhận dạng riêng biệt của ảnh chụp nhanh đã thu thập thông tin quan sát này.
capture_location	STRUCT	Cấu trúc chứa toạ độ vĩ độ/kinh độ dưới dạng số thực biểu thị tâm của xe khi quan sát được ghi lại.
capture_time	DẤU THỜI GIAN	Dấu thời gian khi quan sát được ghi lại. Dấu thời gian theo định dạng ISO 8601, ví dụ: 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	Vị trí của góc LLA và Euler của camera. Cấu trúc chứa số thực cho vĩ độ/kinh độ, cao độ (tính bằng mét), độ dốc, hướng và độ nghiêng (tính bằng độ).
gcs_uri	STRING	URI Google Cloud Storage nơi lưu trữ hình ảnh.
map_url	STRING	URL của Google Maps cho biết vị trí chụp ảnh của quan sát.
pano_id	STRING	Giá trị nhận dạng riêng biệt cho một hình ảnh toàn cảnh 360 độ được ghép nối. Giá trị này có thể rỗng; có thể không có giá trị này. Nếu có, bạn có thể dùng mã này làm khoá truy cập với API tĩnh Chế độ xem đường phố của Google Maps.

Bảng không dùng nữa

Lưu ý: Các bảng all_observations, latest_observations, all_assets và latest_assets không còn được dùng nữa và sẽ bị xoá trong một bản phát hành sau này. Thay vào đó, hãy sử dụng bảng cho từng sản phẩm được mô tả trên trang này.