ru.dgis.sdk.directory.SearchQueryBuilder | Android SDK | 2GIS Documentation
Android SDK
Maps
Search
Navigation

SearchQueryBuilder

Построитель поисковых запросов. Поиск осуществляется по глобальному индексу, а также по локальным индексам сегментов, где сегмент - это некоторый кусок разбиения глобальной карты. Процедура выбора сегментов для поиска осуществляется следующими способами (по убыванию приоритета):

  • Если явно задается область в виде полигона в запросе (spatial_restriction), то она учитывается в первую очередь. Способы ниже по приоритету отключаются, однако используются для учёта расстояний в релевантности поиска.
  • При указании прямоугольной области интереса (bounding_rect), поиск ведется в некоторой ее окрестности.
  • Если не указаны вышестоящие по приоритету параметры, то учитывается точка положения пользователя.

    • TODO: Данное условие пока не работает. Будет исправлено в ближайших релизах.

  • При упоминании в тексте запроса широко известного объекта (город, область или другой топоним) добавляется в поиск тот сегмент, в который попадает точка найденного объекта из глобального индекса.
  • Если не указано ничего из вышеперечисленного, то осуществляется поиск по глобальному индексу.

    • Extends: ru.dgis.sdk.NativeObject
    Methods
    fun setSpatialRestriction(spatialRestriction: List?<GeoPoint>): SearchQueryBuilder

    Задать ограничение области поиска в форме полигона. Первая и последняя точки полигона не обязаны совпадать.

    по умолчанию ограничение отсутствует

    Parameters
    spatialRestriction
    Returns
    fun setAreaOfInterest(rect: GeoRect?): SearchQueryBuilder

    Задать прямоугольную область интереса в географических координатах. Типичным значением является visible_rect из ICamera - объемлющий прямоугольник области просмотра.

    Parameters
    rect
    Returns
    fun setLocation(locationPoint: GeoPoint?): SearchQueryBuilder

    Задать текущее положение пользователя, относительно которого будет фильтрация и поиск.

    Parameters
    locationPoint
    Returns
    fun setAllowedResultTypes(allowedResultTypes: List<ObjectType>): SearchQueryBuilder

    Задать типы объектов, разрешенные в результате запроса.

    по умолчанию все, кроме Route

    Parameters
    allowedResultTypes
    Returns
    fun setPageSize(pageSize: Int): SearchQueryBuilder

    Задать предпочитаемое количество элементов на странице результатов. Допустимы значения из диапазона 1;50

    по умолчанию 10

    Parameters
    pageSize
    Returns
    fun setDirectoryFilter(filter: DirectoryFilter): SearchQueryBuilder

    Задать фильтрацию для поискового запроса.

    Parameters
    filter
    Returns
    fun setSortingType(sortingType: SortingType): SearchQueryBuilder

    Задать сортировку для поискового запроса.

    Parameters
    sortingType
    Returns
    fun build(): SearchQuery

    Сформировать поисковый запрос.

    Returns
    fun finalize(): Unit
    Returns
    @JvmStatic
fun fromQueryText(queryText: String): SearchQueryBuilder

    Начать построение текстового поискового запроса c указанным текстом.

    Parameters
    queryText
    Returns
    @JvmStatic
fun fromQuery(query: SearchQuery): SearchQueryBuilder

    Начать построение запроса на основе запроса #query для изменения части параметров.

    Исходный запрос #query остается без изменений

    Parameters
    query
    Returns