Korzystanie z okolicznych budynków i terenu w pakiecie Android SDK (Kotlin/Java)

Interfejsy Streetscape Geometry API zapewniają geometrię terenu, budynków i innych obiektów w scenie. Geometrii można używać do przesłonięcia, renderowania i umieszczania treści AR za pomocą interfejsów API do testów trafień. Dane geometryczne Streetscape uzyskuje się ze zdjęć Google Street View.

Zobacz fragment

Przykładowa aplikacja geospatial_java pokazuje, jak uzyskać i wyrenderować geometrię Streetscape.

Konfigurowanie interfejsu Geospatial API

Aby korzystać z funkcji Streetscape Geometry, musisz skonfigurować w projekcie interfejs Geospatial API. Aby skonfigurować interfejs Geospatial API, postępuj zgodnie z instrukcjami włączania interfejsu Geospatial API.

Włącz geometrię Streetscape

Interfejs Geospatial API pobiera dane Streetscape Geometry, gdy GeospatialMode ma wartość GeospatialMode.ENABLED, a StreetscapeGeometryMode jest ustawiona na StreetscapeGeometryMode.ENABLED.

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

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
  }
)

Uzyskiwanie geometrii Streetscape w sesji ARCore

session.getAllTrackables(StreetscapeGeometry.class);

session.getAllTrackables(StreetscapeGeometry::class.java)

Informacje o StreetscapeGeometry

StreetscapeGeometry zawiera informacje o budynku:

• StreetscapeGeometry.getType()
  Identyfikuje obiekt StreetscapeGeometry jako teren lub budynek.
• StreetscapeGeometry.getMesh()
  Znajdź wielokąt Mesh odpowiadający temu terenowi lub budynku.
• StreetscapeGeometry.getMeshPose()
  Opisuje pochodzenie geometrii. Wszystkie punkty w elemencie Mesh powinny zostać przekształcone w obiekty StreetscapeGeometry.getMeshPose().
• StreetscapeGeometry.getQuality()
  Zapewnia jakość danych sieci typu mesh. Poziomy szczegółowości znajdziesz w standardzie CityGML 2.0.

Budynek – LOD 1

StreetscapeGeometry.Quality.BUILDING_LOD_1 to kontury budynków rozciągnięte w górę na płaskie dach. Wysokość budynków może być niedokładna.

Budynek LOD 2

StreetscapeGeometry.Quality.BUILDING_LOD_2 będzie mieć wyższą dokładność geometrii. Ściany z siatki i dachy będą lepiej dopasowane do kształtu budynku. Mniejsze elementy, takie jak kominy czy otwory dachowe, mogą nadal pojawiać się na zewnątrz siatki.

Informacje o Mesh

Mesh to wielokątna siatka reprezentująca zrekonstruowaną powierzchnię geometrii Streetscape. Każdy element Mesh zawiera bufor wierzchołkowy i bufor indeksu:

• Mesh.getVertexListSize()
  Pobiera liczbę wierzchołków w tej siatce.
• Mesh.getVertexList()
  Uzyskaj połączone położenie wierzchołków siatki we współrzędnych względem StreetscapeGeometry.getMeshPose()
• Mesh.getIndexListSize()
  Pobiera liczbę indeksów w tej siatce.
• Mesh.getIndexList()
  Uzyskaj indeksy wierzchołków tworzących twarz.

Załączanie treści AR do StreetscapeGeometry

• Włącz opcję Głębokość geoprzestrzenna i użyj testu działań związanych z głębokością. Jest to zalecana i łatwiejsza metoda.
• Użyj narzędzia Trackable.createAnchor(), aby utworzyć reklamę zakotwiczoną w danej pozycji dołączonej do elementu StreetscapeGeometry. Ta kotwica odziedziczy stan śledzenia z elementu nadrzędnego StreetscapeGeometry.

Przeprowadź test trafień na StreetscapeGeometry

Frame.hitTest() może służyć do testowania trafień pod kątem geometrii Streetscape. Po znalezieniu przecięć parametr HitResult zawiera informacje o położeniu dotyczące lokalizacji działania oraz odwołanie do trafienia StreetscapeGeometry. Tę geometrię Streetscape można przekazać do obiektu Trackable.createAnchor(), aby utworzyć dołączoną do niej kotwicę.

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

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

Włącz głębię geoprzestrzenną

Głębokość geoprzestrzenna łączy geometrię Streetscape z lokalnym czujnikiem w celu ulepszenia danych o głębi. Gdy włączona jest funkcja Głębokość geoprzestrzenna, Obrazy głębi wyjściowej i nieprzetworzonej głębi są modyfikowane tak, by oprócz lokalnie obserwowanej głębi uwzględnić zrasteryzowaną geometrię Streetscape. Może to poprawić dokładność pozycji z wykorzystaniem głębi.