coordinates_simple (gis_search)
Para obtener las coordenadas indicando la dirección, utilice la siguiente solicitud:
https://search-maps.wialon.com/<host>/gis_search?country="<text>"®ion="<text>"&city="<text>"&street="<text>"&
flags=<uint>&count=<uint>&indexFrom=<uint>&uid=<long>
El
Parámetros
Los parámetros obligatorios están marcados con un asterisco (*).
| Nombre | Descripción |
|---|---|
| country | Nombre de un país o parte de él. |
| region | Nombre de una región o parte de ella. |
| city | Nombre de una ciudad o parte de ella. |
| street | Nombre de una calle o parte de ella. |
| flags* | Flags de búsqueda y formato. Consulte la descripción a continuación. |
| count* | Número de resultados que se devuelven. |
| indexFrom | Número de orden del primer resultado. |
| searchFlags* | Flags de búsqueda adicionales. Consulte la descripción a continuación. |
| gis_sid* | ID único de la sesión del usuario. |
| uid | ID del usuario actual. Obsoleto; utilice siempre gis_sid. |
Flags de búsqueda
| Flag | Descripción |
|---|---|
| 0x100 | Incluir la ruta de la dirección en el resultado. |
| 0x200 | Incluir el nombre del mapa en el resultado. |
| 0x400 | Incluir las coordenadas del mapa en el resultado. |
| 0x800 | No crear JSON. Devolver los resultados como una lista de objetos. |
Flags
| Flag | Descripción |
|---|---|
| 0x0 | Buscar país. |
| 0x1 | Buscar región. |
| 0x2 | Buscar ciudad. |
| 0x3 | Buscar calle. |
| 0x4 | Buscar casa. |
| 0x100 | Agregar al resultado campos con la ruta de la dirección formateada. |
| 0x200 | Agregar el nombre del mapa al resultado. |
| 0x400 | Agregar las coordenadas al resultado. |
Los flags de formato se describen aquí.
Códigos de error
| Código de error | Descripción |
|---|---|
| 1 | Sesión no válida. |
| 4 | Parámetros de entrada incorrectos. |
| 6 | Error desconocido. |
| 7 | Acceso denegado: proveedor de búsqueda desconocido. |
Respuesta
{
"items":[ /* array de resultados */
{
"name":"<text>", /* nombre del elemento de búsqueda*/
"map":"<text>", /* nombre del mapa */
"x":<double>, /* longitud */
"y":<double>, /* latitud */
"path":"<text>", /* parte de la ruta de la dirección, sin incluir la parte indicada en "name" */
"formatted_path":"<text>" /* cadena de dirección formateada según los flags */
}
],
"more":<uint> /* resultados adicionales: 0 - no, 1 - sí */
}