address (gis_geocode)
Wialon permite determinar las coordenadas a partir de una dirección, así como determinar la dirección a partir de las coordenadas. Para obtener la dirección a partir de unas coordenadas conocidas, utilice la siguiente solicitud:
https://geocode-maps.wialon.com/<host>/gis_geocode?coords=[{"lon":<double>,"lat":<double>}]&city_radius=<uint>&
dist_from_unit=<uint>&txt_dist="<text>"&flags=<uint>&uid=<long>&gis_sid="<text>"&search_provider="<text>"
Normalmente, como
Parámetros
Los parámetros obligatorios están marcados con un asterisco (*).
| Nombre | Descripción |
|---|---|
| coords* | Array de coordenadas [{“lon”:<double>,“lat”:<double>}]. |
| city_radius | Radio mínimo de la ciudad, km. Si no se encuentra ninguna ciudad dentro de la distancia máxima desde la unidad (la opción siguiente), la dirección se asocia a otra ciudad. En este parámetro, puede especificar el tamaño mínimo de la ciudad que se debe usar para formar la dirección. Esto permite excluir las ciudades pequeñas de las direcciones. |
| dist_from_unit | Distancia máxima desde la unidad, km. Si la unidad se encuentra cerca de una vía y hay una ciudad, un pueblo o una aldea dentro de la distancia indicada, la línea de dirección muestra el nombre de la vía y la distancia hasta esa localidad. |
| txt_dist | Unidades de medida de la distancia máxima desde la unidad. |
| flags* | Flags del formato de salida (consulte más abajo). |
| uid | ID del usuario actual. Obsoleto; utilice siempre gis_sid. |
| gis_sid* | ID único de la sesión del usuario. |
| search_provider* | Nombre del proveedor. Los valores posibles de search_provider son google, sygic, yandex, here, trimble. |
| lang | Idioma. |
| house_detect_radius | Si la dirección más cercana es una calle, se busca una casa a una distancia de house_detect_radius (25 metros de forma predeterminada) para precisar, si es posible, la ubicación en esa calle. Si se encuentra la casa y su calle coincide con la calle donde se encontró el objeto, la casa se toma como dirección. De lo contrario, solo se toma la calle. |
El formato de dirección predeterminado es 45321 (calle, casa, ciudad, región, país). Puede cambiarlo con los dígitos del 1 al 5:
| Dígito | Descripción |
|---|---|
| 1 | País |
| 2 | Región |
| 3 | Ciudad |
| 4 | Calle |
| 5 | Casa |
Para definir el formato, utilice cualquiera de estos dígitos cinco veces o menos. Este formato de salida se incluye en flags según el siguiente algoritmo: cada dígito se especifica con 3 bits, a partir del bit 31. Esto significa que la cantidad máxima de bits utilizados es 15 (del 31 al 17).
| Formato | Decimal | Binario | Resultado |
|---|---|---|---|
| 45321 | 1255211008 | 0 100 101 011 010 001 0000000000000000 | Calle, casa, ciudad, región, país. |
| 45 | 1241513984 | 0 100 101 000 000 000 0000000000000000 | Calle, casa. |
| 33333 | 920322048 | 0 011 011 011 011 011 0000000000000000 | Ciudad, ciudad, ciudad, ciudad, ciudad. |
Flags adicionales
| Valor | Descripción |
|---|---|
| 512 | Devolver datos MGRS. |
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 desconocido. |
Respuesta
["<text>"] /* array de direcciones */