coordinates_simple (gis_search)
Чтобы получить координаты по адресу, используйте следующий запрос:
https://search-maps.wialon.com/<host>/gis_search?country="<text>"®ion="<text>"&city="<text>"&street="<text>"&
flags=<uint>&count=<uint>&indexFrom=<uint>&uid=<long>
Как
Параметры
Обязательные параметры отмечены звездочкой (*).
Параметр | Описание |
|---|---|
country | Название страны или его часть. |
region | Название региона или его часть. |
city | Название города или его часть. |
street | Название улицы или его часть. |
flags* | Флаги поиска или форматирования. См. описание ниже. |
count* | Количество выводимых результатов. |
indexFrom | Порядковый номер первого результата. |
| searchFlags* | Дополнительные флаги поиска. См. описание ниже. |
| gis_sid* | Уникальный ID сессии пользователя. |
uid | ID пользователя. Устарело, всегда используйте gis_sid. |
Флаги поиска
| Флаг | Описание |
|---|---|
| 0x100 | Вывести путь в результат. |
| 0x200 | Вывести имя карты в результат. |
| 0x400 | Вывести координаты в результат. |
| 0x800 | Не создавать JSON. Вернуть результаты как список объектов. |
Флаги
Флаг | Описание |
|---|---|
0x0 | Искать страну. |
0x1 | Искать регион. |
0x2 | Искать город. |
0x3 | Искать улицу. |
0x4 | Искать дом. |
0x100 | Добавить поля с форматированной строкой адреса в результат. |
0x200 | Добавить название карты в результат. |
0x400 | Добавить координаты карты в результат. |
Флаги форматирования описаны здесь.
Коды ошибок
| Код | Описание |
|---|---|
| 1 | Невалидная сессия. |
| 4 | Неверные вводные параметры. |
| 6 | Неизвестные ошибки. |
| 7 | Нет доступа, неизвестный провайдер поиска. |
Возвращаемый результат
{
"items":[ /* массив результатов */
{
"name":"<text>", /* название элемента поиска */
"map":"<text>", /* название карты */
"x":<double>, /* долгота */
"y":<double>, /* широта */
"path":"<text>", /* часть адреса, исключая названия элемента, указанного в поле name */
"formatted_path":"<text>" /* строка адреса, отформатированная в соответствии с установленными флагами */
}
],
"more":<uint> /* дополнительные результаты: 0 — нет, 1 — есть */