Wialon для разработчиков Руководство пользователя Документация API Другие методы coordinates_intelli (gis_searchintelli)

coordinates_intelli (gis_searchintelli)

Этот поиск удобен тем, что не нужно указывать, что именно вы ищете: улицу, страну, дом и так далее. Достаточно одной фразы с произвольным порядком слов. Запрос возвращает результаты в формате по умолчанию: форматированную строку адреса, координаты и название карты. Чтобы получить координаты по адресу, указанному в произвольном формате, используйте следующий запрос:

Copied!

https://search-maps.wialon.com/<host>/gis_searchintelli?phrase="<text>"&count=<uin t>&
indexFrom=<uint>&uid=<long>...

Как обычно используется hst-api.wialon.com.

Параметры

Обязательные параметры отмечены звездочкой (*).

Название	Описание
phrase*	Фраза для поиска.
count*	Количество выводимых результатов.
indexFrom	Порядковый номер первого результата.
uid	ID текущего пользователя. Устарело, всегда используйте gis_sid.
gis_sid*	Уникальный ID сессии пользователя.
search_provider*	Название провайдера. Возможные значения search_provider: google, sygic, yandex, here, trimble.
flags	Флаги поиска и форматирования (см. ниже).
searchFlags*	Дополнительные флаги поиска (см. ниже).
lang	Язык.
allow_irrelevant	1 — активен, разрешить нерелевантный результат.

Флаги поиска

Флаг	Описание
0x100	Вывести путь в результат.
0x200	Вывести название карты в результат.
0x400	Вывести координаты карты в результат.
0x800	Не создавать JSON. Вернуть результаты как список объектов.

Флаги

Флаг	Описание
0x0	Искать страну.
0x1	Искать регион.
0x2	Искать город.
0x3	Искать улицу.
0x4	Искать дом.
0x100	Добавить в результат поля с форматированной строкой адреса.
0x200	Добавить в результат название карты.
0x400	Добавить в результат координаты.

Ответ

Copied!

[
	{
		"items":[
			{
				"name":"<text>",		/* название элемента поиска */
				"map":"<text>",		/* название карты */
				"x":<double>,		/* долгота */
				"y":<double>,		/* широта */
				"path":"<text>",		/* часть адреса, исключая часть, указанную в поле name */
				"formatted_path":"<text>"	/* строка адреса, отформатированная в соответствии с флагами */
			}
		],
		"country":"<text>",	/* страна */
		"region":"<text>",	/* регион */
		"city":"<text>",		/* город */
		"street":"<text>",	/* улица */
		"house":"<text>",		/* дом */
		"flags":<uint>,		/* флаги */
		"more":<uint>		/* дополнительные результаты: 0 — нет, 1 — есть */
	}
]

Флаги, которые показывают степень детализации результата:

Флаг	Описание
0x0	Страна
0x1	Регион
0x2	Город
0x3	Улица
0x4	Дом

Коды ошибок

Код ошибки	Описание
1	Невалидная сессия.
4	Неверные входные параметры.
6	Неизвестная ошибка.
7	Нет доступа, неизвестный провайдер поиска.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.