Sử dụng các toà nhà và địa hình xung quanh bạn trên SDK Android (Kotlin/Java)

Streetscape Geometry API cung cấp hình dạng địa hình, tòa nhà hoặc các cấu trúc khác trong một cảnh. Hình dạng này có thể được dùng để che khuất, hiển thị hoặc đặt nội dung thực tế tăng cường (AR) thông qua API kiểm thử nhấn. Dữ liệu Hình học cảnh quan đường phố được lấy qua hình ảnh trong Chế độ xem đường phố của Google.

Dùng thử mẫu

Ứng dụng mẫu geospatial_java minh hoạ cách lấy và kết xuất Hình học cảnh đường phố.

Thiết lập API Không gian địa lý

Để sử dụng Hình học cảnh đường phố, bạn cần phải thiết lập API Không gian địa lý trong dự án của mình. Làm theo hướng dẫn về cách Bật API không gian địa lý để thiết lập API không gian địa lý.

Bật Hình học phong cảnh đường phố

API Không gian địa lý thu thập dữ liệu Hình học cảnh quan đường phố khi GeospatialMode được đặt thành GeospatialMode.ENABLED và StreetscapeGeometryMode được đặt thành StreetscapeGeometryMode.ENABLED.

Java

Config config = session.getConfig();
// Streetscape Geometry requires the Geospatial API to be enabled.
config.setGeospatialMode(Config.GeospatialMode.ENABLED);
// Enable Streetscape Geometry.
config.setStreetscapeGeometryMode(Config.StreetscapeGeometryMode.ENABLED);
session.configure(config);

Kotlin

session.configure(
  session.config.apply {
    // Streetscape Geometry requires the Geospatial API to be enabled.
    geospatialMode = Config.GeospatialMode.ENABLED
    // Enable Streetscape Geometry.
    streetscapeGeometryMode = Config.StreetscapeGeometryMode.ENABLED
  }
)

Nhận Hình học cảnh đường phố trong phiên ARCore

Sử dụng Session.getAllTrackables() và sử dụng StreetscapeGeometry.class để lọc kết quả.

Java

session.getAllTrackables(StreetscapeGeometry.class);

Kotlin

session.getAllTrackables(StreetscapeGeometry::class.java)

Tìm hiểu StreetscapeGeometry

StreetscapeGeometry chứa thông tin về một toà nhà:

Toà nhà LOD 1

StreetscapeGeometry.Quality.BUILDING_LOD_1 bao gồm phạm vi của toà nhà được nhô lên trên mặt phẳng. Chiều cao của toà nhà có thể không chính xác.

Toà nhà LOD 2

StreetscapeGeometry.Quality.BUILDING_LOD_2 sẽ có hình học độ trung thực cao hơn. Tường và mái lưới sẽ phù hợp hơn với hình dạng của toà nhà. Các đặc điểm nhỏ hơn như ống khói hoặc lỗ thông gió trên mái nhà vẫn có thể bị chọc vào bên ngoài lưới.

Tìm hiểu Mesh

Mesh là một lưới đa giác thể hiện bản dựng lại bề mặt của Hình học cảnh quan đường phố. Mỗi Mesh bao gồm một vùng đệm đỉnh và vùng đệm chỉ mục:

Đính kèm nội dung thực tế tăng cường (AR) vào StreetscapeGeometry

Có hai cách để đính kèm nội dung thực tế tăng cường (AR) vào Hình học cảnh đường phố:

Thực hiện thử nghiệm nhấn với StreetscapeGeometry

Bạn có thể sử dụng Frame.hitTest() để kiểm tra nhanh theo Hình học cảnh đường phố. Nếu tìm thấy giao lộ, HitResult chứa thông tin về tư thế về vị trí bị va chạm cũng như thông tin tham chiếu đến StreetscapeGeometry nơi bị va chạm. Bạn có thể truyền Hình học cảnh đường phố này đến Trackable.createAnchor() để tạo neo đi kèm.

Java

for (HitResult hit : frame.hitTest(singleTapEvent)) {
  if (hit.getTrackable() instanceof StreetscapeGeometry) {
    Pose hitPose = hit.getHitPose();
    hit.getTrackable().createAnchor(hitPose);
  }
}

Kotlin

for (hit in frame.hitTest(singleTapEvent)) {
  if (hit.trackable is StreetscapeGeometry) {
    val hitPose = hit.hitPose
    hit.trackable.createAnchor(hitPose)
  }
}

Bật độ sâu không gian địa lý

Độ sâu không gian địa lý kết hợp Hình học cảnh đường phố với đầu vào cảm biến cục bộ để cải thiện dữ liệu về độ sâu. Khi bật Độ sâu không gian địa lý, hình ảnh độ sâu đầu ra và độ sâu thô được sửa đổi để bao gồm Hình học cảnh quan đường phố đã tạo điểm ảnh ngoài độ sâu quan sát được cục bộ. Điều này có thể cải thiện độ chính xác của các tư thế sử dụng tính năng Chiều sâu.