coordinates_intelli (gis_searchintelli)
This search is convenient because you don’t need to specify whether you are searching for a street, country, house, etc. One phrase with an arbitrary word order is enough for this search. This request returns results in the default format: the formatted address path, coordinates, and the map name. To get coordinates by specifying the address in any custom format, use the following request:
https://search-maps.wialon.com/<host>/gis_searchintelli?phrase="<text>"&count=<uin t>&
indexFrom=<uint>&uid=<long>...
The
Parameters
The required parameters are marked with an asterisk (*).
Name | Description |
|---|---|
phrase* | Search phrase. |
count* | Number of output results. |
indexFrom | Sequence number of the first result. |
uid | Current user ID. Deprecated, always use gis_sid. |
| gis_sid* | Unique ID of the user session. |
| search_provider* | Provider name. Possible values of search_provider are google, sygic, yandex, here, trimble. |
| flags | Search and format flags (see below). |
| searchFlags* | Additional search flags (see below). |
| lang | Language. |
| allow_irrelevant | 1 - active, allow irrelevant result. |
Search flags
| Flag | Description |
|---|---|
| 0x100 | Dump the path in the result. |
| 0x200 | Dump the map name in the result. |
| 0x400 | Dump the map coordinates in the result. |
| 0x800 | Do not create JSON. Return results as a list of objects. |
Flags
Flag | Description |
|---|---|
0x0 | Search country. |
0x1 | Search region. |
0x2 | Search city. |
0x3 | Search street. |
0x4 | Search house. |
0x100 | Add fields with a formatted address path to the result. |
0x200 | Add the map name to the result. |
0x400 | Add coordinates to the result. |
Response
[
{
"items":[
{
"name":"<text>", /* name of the search item */
"map":"<text>", /* map name */
"x":<double>, /* longitude */
"y":<double>, /* latitude */
"path":"<text>", /* part of the address path, excluding the part placed in "name" */
"formatted_path":"<text>" /* address string formatted according to the flags */
}
],
"country":"<text>", /* country */
"region":"<text>", /* region */
"city":"<text>", /* city */
"street":"<text>", /* street */
"house":"<text>", /* house */
"flags":<uint>, /* flags */
"more":<uint> /* additional results: 0 - no, 1 - yes */
}
]
The flags that show how detailed the result is:
Flag | Description |
|---|---|
0x0 | Country |
0x1 | Region |
0x2 | City |
0x3 | Street |
0x4 | House |
Error codes
| Error code | Description |
|---|---|
| 1 | Invalid session. |
| 4 | Wrong input parameters. |
| 6 | Unknown error. |
| 7 | Access denied, unknown search provider. |