This is documentation of a bèta release.
For documentation on the current version, please check Knowledge Base.

This is an old revision of the document!


Add View

Click on the '+' icon and view mode on the left sidebar to open a new view. Next, click on the Reference View or an existing View on the location where a new View should be opened.
The available reality data will define the available Open View options.
The different View modes are described here.

Find Best Photo

FIXME Add find photo algorithm information

Parameters :

  • viewPosition : The position of the viewer (optional).
  • returnSphericals : Return spherical photo positions?
  • returnPlanars : Return planar photo positions?
  • minPhotos : The minimum amount of photos to find after applying the requireFocusVisible filter. Ignored if not positive.
  • minDistance2D : The minimum 2D distance of photo's to the search position (metric). Used when searching for streetlevel photo's. Ignored if not positive.
  • relevantPhotosMax : The maximum number of relevant photos to return.
  • searchDistances2D : The array of search distances to use when finding a closest photo.
  • findCloserPhotoAlgorithm : The algorithm to use to find a closest photo.
    • PIXEL_DISTANCE : Identifies the technique to find a closest photo by projecting the search coordinate on the photo and then sorting by distance to the photo center.
    • SPATIAL_DISTANCE : Identifies the technique to find a closest photo by taking the 3d distance to the view position (fall back on focus position).
  • directionFilter : Only return photo's in a specific direction? (null to disable)
  • tagFilter : Only return photo's from resources that match the given tag filter? (null to disable)
  • timeFilter : Only return photo's from resources that match the given time filter? (null to disable)
  • requireFocusVisible : For planars, only return photo's that have the search position inside the photo? (false to disable)
  • isStreetlevel : We are searching on streetlevel?
    • If true the 'is focus visible?' check (enabled by requireFocusVisible) will check whether the focus position is in view
    • for each photo by looking at the angular distance between the photo heading (pan) and the heading defined by the vector from photo position to focus position.
    • This yields a better result for streetlevel planars (sphericals don't have a 'focus visible' check).
  • tagFilterApplyOnResourceGroupChildren : If tagFilter is specified, this parameter determines whether in case of a resource group, it applies to the children only. false means it applies to the parent resource only.
  • timeFilterApplyOnResourceGroupChildren : If timeFilter is specified, this parameter determines whether in case of a resource group, it applies to the children only. false means it applies to the parent resource only.
  • searchCenter : Identifies searching around the view position.
    • FOCUS : Identifies searching around the focus position and selecting the photo closest to the focus position.
    • FOCUS_AND_VIEW : Identifies searching around the focus position and selecting the photo closest to the view position if provided (focus position as fallback).
    • VIEW : Identifies searching around the view position and selecting the photo closest to the view position.
  • AerialDistances = 25,50,100,200,400,800,1600,3200,6400,12800
  • StreetlevelDistances = 3,9,27,81,243,729
Streetlevel Spherical Streetlevel Planar UAV Planar Oblique Planar
returnSphericals true false false false
returnPlanars false true true true
minPhotos 0 0 3 0
minDistance2D 0 0 0 0
relevantPhotosMax 10 10 10 10
searchDistances2D StreetlevelDistances StreetlevelDistances AerialDistances AerialDistances
findCloserPhotoAlgorithm SPATIAL_DISTANCE SPATIAL_DISTANCE1 SPATIAL_DISTANCE1 PIXEL_DISTANCE1
requireFocusVisible false true true true
isStreetlevel true true false false
searchCenter FOCUS_AND_VIEW2 FOCUS_AND_VIEW2 FOCUS_AND_VIEW2 FOCUS

1 Configurable via Views → Image View → Open best planar photo by
2 Configurable via Views → Image Views → Open image from 3D View

 
Last modified:: 2023/02/09 19:21