Виджет Поиск позволяет настроить инструмент поиска для нахождения объектов, записей или местоположений на основе определенных слоев и локаторов, а также определить способ отображения результатов поиска в веб-интерфейсе. Если вы добавите в виджет несколько источников поиска, пользователи смогут выбирать, какие из них использовать для поиска. Выполнение поиска с использованием источника слоя влияет на данные в вашем приложении, так как к другим виджетам, использующим тот же слой, применяется фильтр для отображения соответствующих результатов поиска. Если вы хотите сделать результаты поиска доступными для выборки, можно задать действие. Чтобы виджет мог выделять объекты без фильтрации данных, создайте представление данных для источников данных, которые будут использоваться как источник слоя. Выполнение поиска с использованием источника локатора создает выходной источник данных, который могут использовать другие виджеты.
Для осуществления поиска пользователи вводят слово или фразу в поле поиска и нажимают Enter, затем щелкают кнопку поиска или выбирают из списка предложений, появляющегося на основе сопоставленных записей. (В списке предложений каждое сопоставленное значение отображается как элемент, поэтому, если в записи есть два поля, соответствующих поисковой фразе, эта запись отображается как два предложения.) Пользователи могут воспользоваться стрелками Вверх и Вниз для пролистывания раздела. При щелчке по предложению поисковая фраза заменяется содержимым из предложенного элемента, чтобы применить к поиску новое значение и возвратить соответствующие данные в панели результатов. Для упрощения, можно включить опцию автоматического выбора первого результата. Вы можете настроить виджет на открытие другой страницы в вашем приложении, чтобы отображать результаты в другом виджете.
Примеры
Используйте этот виджет для поддержки требований к разработке приложений, таких как:
- Вы хотите настроить опцию поиска в своем приложении, чтобы обеспечить ему большую гибкость, чем при использовании инструмента поиска, включенного в виджеты Карта, Список и Таблица. В частности, вы хотите выполнять поиск по ограниченным полям и для определенных слоев на карте, предоставить уникальный текст подсказки в поле поиска и отобразить в панели результатов значения определенных полей данных.
- Вы хотите, чтобы при выполнении поиска пользователи находили информацию из нескольких источников.
- Вы хотите отображать результаты поиска в других виджетах на другой странице вашего приложения.
Примечания по использованию
Виджет поиска поддерживает два типа источников поиска - слои и локаторы. Когда вы добавляете виджет Поиск, локаторы, указанные в настройках организации, по умолчанию добавляются как источники локаторов. (Если вы не видите ArcGIS World Geocoding Service по умолчанию, ваш администратор мог удалить его из настроек организации.) Чтобы использовать другой источник локатора, добавьте URL-адрес сервиса локатора. Для поиска слоев выберите из векторных слоев и слоев сцены, добавленных в качестве данных в ваше приложение.
Вы можете настроить действия для виджета Поиск, чтобы он взаимодействовал с другими виджетами в вашем приложении, например масштабировал карту до выбранного результата или отображал результаты поиска (из источника локатора) на карте.
Настройки
Виджета Поиск включает следующие настройки:
- Новый источник поиска - при желании можно добавить источники для поиска ресурсов, отличные от используемых по умолчанию. Выберите Источник слоя или Источник локатора и укажите следующие настройки для каждого:
- Данные - если применимо, выберите источник данных для векторного слоя, по которому вы хотите осуществлять поиск. В настройках просмотра данных вы можете применить фильтр к данным, чтобы ограничить область поиска, или отсортировать данные, чтобы отображать результаты поиска в определенном порядке.
- URL-адрес локатора - если применимо, укажите URL-адрес сервиса локатора (который начинается с https://). Виджет автоматически использует локаторы, заданные в настройках организации.
- Надпись - введите имя источника поиска. Это имя отображается в меню поиска, списке предложений и в панели результатов.
- Значок - выберите значок для источника. Этот значок отображается в списке предложений и в панели результатов поиска. Вы можете выбрать значки из галерей Общие и Стрелки, либо добавить собственный значок из файла. Щелкните кнопку Удалить, чтобы удалить неиспользуемые загруженные значки.
Примечание:
Можно выгружать следующие форматы изображений: PNG, GIF, JPG, JPEG и BMP. Чтобы сохранить оптимальную производительность, на размер каждой загрузки есть ограничение в 10МБ.
- Опции поиска - настройте текст подсказки, которая появляется в поле поиска, когда пользователи выбирают поиск только в этом источнике. Для Источника слоя вы можете установить следующие дополнительные опции:
- Выбрать поля поиска - выберите одно или несколько полей для поиска в слое.
- Точное совпадение — ограничьте результаты поиска только теми записями, которые соответствуют поисковой фразе.
- Отображаемые поля - выберите одно или несколько полей для отображения в панели результатов поиска. Вы можете перетащить выбранные поля, чтобы изменить их порядок.
- Основные опции поиска
- Подсказка для нескольких источников поиска - настройте текст подсказки, которая появляется в поле поиска, когда пользователи выбирают поиск в нескольких источниках.
- Предложения поиска - определите максимальное количество предложений, которые появляются для каждого источника поиска. Вы также можете настроить следующие опции:
- Использовать текущее местоположение - включите опцию поиска предложений на основе текущего местоположения пользователя.
- Недавние поисковые запросы - отображение истории поиска в поле предложений на основе указанного максимального количества последних поисковых запросов. (Пользователи могут очистить историю поиска.)
Подсказка:
Установите Максимальное предложение на источник равным 0, чтобы отключить предложения источников поиска.
- Результаты поиска - выберите отображение панели результатов поиска или укажите ссылку на страницу вашего приложения для отображения результатов в другом виджете.
- Панель результатов - отобразите результаты поиска в панели, которая открывается под полем поиска. Вы можете задать максимальное количество результатов для каждого источника поиска и выбрать автоматический выбор первого результата.
- Задать ссылку - открывать определенную страницу в вашем приложении для отображения актуальных результатов поиска в соответствующем виджете.
Опции взаимодействия
Когда вы настраиваете действия с сообщениями в виджете Поиск, можно выбрать следующие триггеры, в зависимости от источника поиска.
| Триггер | Исходный слой | Источник локатора |
|---|---|---|
Изменения выборки записей |
|
|
Записи созданы |
| |
Изменения фильтрации данных |
|
При настройке с источником локатора виджет Поиск создает выходной источник данных, который можно использовать в других виджетах. Взаимодействие с дополнительными виджетами с использованием этого же источника данных происходит с помощью добавление действий. Например, карта может автоматически отображать результаты поиска и приближаться к объектам. В настройках виджета Поиск на вкладке Действие добавьте триггер Созданные записи, выберите целевую карту и добавьте действия для Показать на карте и Приблизить к.
Чтобы выбирать на карте объект, соответствующий выбранному результату поиска, добавьте триггер Изменения выборки записей для виджета Поиск (если он настроен для использования панели результатов). Выберите целевую рабочую область, добавьте действие Выбрать записи данных и настройте его с векторным слоем для карты и полями, которые связывают данные триггера и действия. Дополнительно вы можете добавить действие Приблизить к, чтобы приблизить карту к объекту.
При настройке на работу с источником слоя, если вы хотите, чтобы карта масштабировалась или перемещалась к выбранным результатм поиска, добавьте триггер Изменения фильтрации данных, выберите целевую карту и добавьте действия Переместить к и Приблизить к.
Если вы хотите настроить уровень приближения для действия Приблизить к, переключите Масштаб приближения на Пользовательское и введите желаемый масштаб.
Подсказка:
Чтобы виджет Поиск мог выделять объекты на карте без фильтрации данных, создайте представление данных для источников данных, которые будут использоваться как источник слоя.