Поиск индекса мест для предложений
Описание
Генерирует предложения адресов и достопримечательностей на основе частичного или неверно написанного текста произвольной формы. Эта операция также известна как автодополнение, автопредложение или нечеткое сопоставление.
Дополнительные параметры позволяют сузить результаты поиска по прямоугольнику или стране или настроить поиск в сторону определенной точки на земном шаре.
Примечание
Вы можете искать предполагаемые названия мест вблизи указанной позиции, используяBiasPosition, или фильтровать результаты в пределах прямоугольника, используя FilterBBox. Эти параметры взаимоисключающие; использование как BiasPosition, так и FilterBBox в одной команде приводит к ошибке.См. также: Документацию API AWS
Синтаксис
search-place-index-for-suggestions
--index-name <value>
--text <value>
[--bias-position <value>]
[--filter-b-box <value>]
[--filter-countries <value>]
[--max-results <value>]
[--language <value>]
[--filter-categories <value>]
[--key <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--index-name (строка)
--text (строка)
eiffel tow.--bias-position (список)
Дополнительный параметр, указывающий предпочтение предложений мест, которые находятся ближе к указанной позиции.
Если он указан, этот параметр должен содержать пару чисел. Первое число представляет собой координату X или долготу; второе число представляет собой координату Y или широту.
Например, [-123.1174, 49.2847] представляет позицию с долготой -123.1174 и широтой 49.2847.
Примечание
BiasPosition и FilterBBox взаимоисключающие. Указание обоих параметров приводит к ошибке.(двойное)
Синтаксис:
double double ...
--filter-b-box (список)
Дополнительный параметр, который ограничивает результаты поиска, возвращая только предложения в пределах указанного прямоугольника.
Если он указан, этот параметр должен содержать четыре последовательных числа в двух парах. Первая пара чисел представляет координаты X и Y (долготу и широту соответственно) юго-западного угла прямоугольника; вторая пара чисел представляет координаты X и Y (долготу и широту соответственно) северо-восточного угла прямоугольника.
Например, [-12.7935, -37.4835, -12.0684, -36.9542] представляет прямоугольник, где юго-западный угол имеет долготу -12.7935 и широту -37.4835, а северо-восточный угол имеет долготу -12.0684 и широту -36.9542.
Примечание
FilterBBox и BiasPosition взаимоисключающие. Указание обоих параметров приводит к ошибке.(двойное)
Синтаксис:
double double ...
--filter-countries (список)
Дополнительный параметр, который ограничивает результаты поиска, возвращая только предложения в пределах указанного списка стран.
- Используйте трехзначный код страны ISO 3166. Например, Австралия использует три заглавные буквы:
AUS.
(строка)
Синтаксис:
"string" "string" ...
--max-results (целое число)
Дополнительный параметр. Максимальное количество результатов, возвращаемых за один запрос.
По умолчанию: 5
--language (строка)
Предпочтительный язык для возвращения результатов. Значение должно быть допустимым тегом языка BCP 47, например, en для английского.
Этот параметр влияет на языки, используемые в результатах. Если язык не указан или не поддерживается для конкретного результата, партнёр автоматически выбирает язык для результата.
Для примера, мы будем использовать греческий язык. Вы ищете Athens, Gr, чтобы получить предложения с параметром language, установленным на en. Найденные результаты, скорее всего, будут возвращены как Athens, Greece.
Если вы установите параметр language на el для греческого языка, то найденный результат, скорее всего, будет возвращён как Αθήνα, Ελλάδα.
Если у поставщика данных нет значения для греческого языка, результат будет на языке, который поддерживается поставщиком.
--filter-categories (список)
Список одной или нескольких категорий Amazon Location для фильтрации возвращаемых мест. Если вы включите более одной категории, результаты будут включать результаты, которые соответствуют любой из перечисленных категорий.
Дополнительную информацию об использовании категорий, включая список категорий Amazon Location, см. в разделе «Категории и фильтрация» в Руководстве разработчика Amazon Location Service.
(строка)
Синтаксис:
"string" "string" ...
--key (строка)
--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки API-запроса. Если предоставлено без значения или со значением input, выводит пример JSON-ввода, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример YAML-ввода, который может быть использован с --cli-input-yaml. Если предоставлено со значением output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить URL по умолчанию команды на заданный URL.
--no-verify-ssl (логическое)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команд.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- вкл
- выкл
- авто
--no-sign-request (логическое)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл с сертификатами CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое сопоставляется с двоичным блоком, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое)
Отключить вывод постраничной навигации.
--cli-auto-prompt (логическое)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (логическое)
Отключить автоматический запрос параметров CLI.
Вывод
Краткое описание -> (структура)
Содержит краткое описание запроса. Выводит входные значения для BiasPosition , FilterBBox , FilterCountries , Language , MaxResults и Text . Также включает DataSource индекса места.
Текст -> (строка)
Смещение -> (список)
Содержит координаты необязательного смещения, указанного в запросе.
Этот параметр содержит пару чисел. Первое число представляет собой координату X или долготу; второе число представляет собой координату Y или широту.
Например, [-123.1174, 49.2847] представляет позицию с долготой -123.1174 и широтой 49.2847 .
(число с плавающей точкой)
Прямоугольник -> (список)
Содержит координаты необязательного прямоугольника, указанного в запросе.
(число с плавающей точкой)
Филтры стран -> (список)
Содержит необязательный фильтр по странам, указанный в запросе.
(строка)
Максимальное количество результатов -> (целое число)
Источник данных -> (строка)
Поставщик геопространственных данных, связанный с ресурсом индекса места, указанным в запросе. Значения могут быть следующими:
- Esri
- Grab
- Here
Дополнительную информацию о поставщиках данных см. в документации Amazon Location Service по поставщикам данных.
Язык -> (строка)
en для английского языка.Филтры категорий -> (список)
Необязательный фильтр категорий, указанный в запросе.
(строка)
Результаты -> (список)
Список предложений мест, которые лучше всего соответствуют поисковому запросу.
(структура)
Содержит предложение места, полученное в результате запроса к ресурсу индекса места.
Текст -> (строка)
Идентификатор места -> (строка)
Уникальный идентификатор места. Вы можете использовать его с операцией GetPlace, чтобы найти место позже или получить полную информацию о месте.
Запрос GetPlace должен использовать тот же ресурс PlaceIndex, что и SearchPlaceIndexForSuggestions, который сгенерировал идентификатор места.
Примечание
Для операцийSearchPlaceIndexForSuggestions идентификатор места возвращается индексами мест, которые используют Esri, Grab или HERE в качестве поставщиков данных.Категории -> (список)
Категории Amazon Location, описывающие место.
Дополнительную информацию об использовании категорий, включая список категорий Amazon Location, см. в разделе «Категории и фильтрация» в руководстве разработчика Amazon Location Service.
(строка)
Дополнительные категории -> (список)
Категории от поставщика данных, описывающие место, которые не сопоставлены ни с одной категорией Amazon Location.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.