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 — есть */