====== Search ======

This page documents the 3DM Viewer Geocode and Object Search Field. \\
{{orbitgis:how_to_find.png?25&nolink |}} [[dev:products:3dm_viewer|]] > Sidebar > Search Icon

===== Concept =====

The Search Field implements spatial search.  Multiple Search Engines are available that each implement a different way of arriving at a spatial location, using text input from the user.  A successful request will result in all Views in the workspace focusing on the resulting spatial location.  

Each view will focus in its own way:
  * The 2D View will focus on the spatial location. If spatial bounds are available, they will affect the map scale.
  * The 3D View will focus on the spatial location at a distance of at most 100 meters.
  * The Photo Views will try to open the best photo for the given spatial location, and focus on the spatial position in the photo.

===== Search by Geocoding =====

This engine allows you to use a third party online geocoding engine like Bing Maps for example. The [[dev:viewer:core:settings|Viewer Settings]] allow you to change the active Geocoding engine.

===== Search by Annotations =====

This engine makes use of the Annotation sidebar's search feature.  Running a search is equivalent to entering a search in the Annotation Sidebar and pressing search, without actually opening the sidebar.

===== Search by Vector Attributes =====

This engine makes use of the Inspector sidebar's search feature.  Running a search is equivalent to entering a search in the Inspector sidebar and pressing search, without actually opening the sidebar.

Views are only focused when "Auto-Focus" is enabled in the [[dev/viewer/core/settings|Inspector Settings]].

Specific use cases are documented in the tooltips of the search field.

===== Search by Linear Reference =====

This engine implements support for [[dev//technology/core/lrs|Linear Reference]] datasets in Orbit. It takes a certain distance as input, and plots the given distance along a line. That position is the result of this query.

Search by Linear Reference is only available when a Linear Referencing Resource has been selected in [[dev:viewer:core:settings]].  A Resource can only be selected as Linear Referencing Resource when it is marked as such in the Resource Specs, and it is added to the workspace in the [[dev/viewer/core/viewer_catalog]].

In case multiple linear reference lines are defined by the dataset, the user will be required to select a line first before a query can take place.

Specific use cases are documented in the tooltips of the search field.