public interface LocationSearchSession extends LocationQuerySession
This session provides methods for searching among Location
objects. The search query is constructed using the
LocationQuery.
getLocationsByQuery()
is the basic search method and
returns a list of Locations.
A more advanced search may be
performed with getLocationsBySearch().
It accepts a
LocationSearch
in addition to the query for the purpose of
specifying additional options affecting the entire search, such as
ordering. getLocationsBySearch()
returns a
LocationSearchResults
that can be used to access the resulting
LocationList
or be used to perform a search within the
result set through LocationSearch.
This session defines views that offer differing behaviors for searching.
Locations may have a query record indicated by their respective record
types. The query record is accessed via the LocationQuery.
Modifier and Type | Method and Description |
---|---|
LocationQuery |
getLocationQueryFromInspector(LocationQueryInspector locationQueryInspector)
Gets a location query from an inspector.
|
LocationSearchResults |
getLocationsBySearch(LocationQuery locationQuery,
LocationSearch locationSearch)
Gets the search results matching the given search query using the
given search.
|
LocationSearch |
getLocationSearch()
Gets a location search.
|
LocationSearchOrder |
getLocationSearchOrder()
Gets a location search order.
|
canSearchLocations, getLocationQuery, getLocationsByQuery, getMap, getMapId, useFederatedMapView, useIsolatedMapView
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
LocationSearch getLocationSearch()
mandatory
- This method must be implemented. LocationSearchOrder getLocationSearchOrder()
LocationSearchOrder
is supplied to a LocationSearch
to specify the ordering
of results.mandatory
- This method must be implemented. LocationSearchResults getLocationsBySearch(LocationQuery locationQuery, LocationSearch locationSearch) throws OperationFailedException, PermissionDeniedException
locationQuery
- the location querylocationSearch
- the location searchNullArgumentException
- locationQuery
or
locationSearch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- locationQuery
or
locationSearch
is not of this servicemandatory
- This method must be implemented. LocationQuery getLocationQueryFromInspector(LocationQueryInspector locationQueryInspector)
LocationSearchResults.
locationQueryInspector
- a location query inspectorNullArgumentException
- locationQueryInspector
is null
UnsupportedException
- locationQueryInspector
is not of this servicemandatory
- This method must be implemented.