Skip to main content

WSReverseGeocoding

Geocodificación inversa: convierte coordenadas GPS (latitud/longitud) en dirección textual usando Nominatim.

Target route

POST /apidev/legacy/WSReverseGeocoding

Status

Reusable with adapter — GeoTareas ya expone reverse geocoding via Nominatim. Falta el adapter que preserve el contrato legacy de request/response y agregue validación WSAutorizacion.


Authentication

{
"WSAutorizacion": {
"Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"Usuario": "usuario@empresa.com",
"Password": "contraseña"
}
}

Request body

CampoTipoObligatorioDescripción
WSAutorizacionobjectCredenciales de autenticación legacy
LatitudnumberLatitud de la coordenada
LongitudnumberLongitud de la coordenada
ZoomintegerNoNivel de detalle (1-18, default: 18)
{
"WSAutorizacion": {
"Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"Usuario": "usuario@empresa.com",
"Password": "contraseña"
},
"Latitud": -34.9058,
"Longitud": -56.1882
}

Response body

CampoTipoDescripción
Resultadostring"OK" o código de error
MensajestringDescripción del resultado
SalidastringRespuesta cruda de Nominatim (JSON string)
DireccionstringDirección formateada legible
{
"Resultado": "OK",
"Mensaje": "",
"Salida": "{\"place_id\":123456,\"display_name\":\"18 de Julio, Montevideo...\"}",
"Direccion": "18 de Julio 1234, Montevideo, Uruguay"
}

Backend service reutilizable

  • Endpoint interno: POST /api/geocoding/nominatim/reverse
  • Función: FunctionNominatim.reverselatlng(lat, lng, zoom)

El adapter legacy recibe WSAutorizacion, valida el Guid, llama a FunctionNominatim.reverselatlng y envuelve la respuesta en el formato legacy.


Migration note

Pendiente de implementación. Es una de las migraciones de menor riesgo del grupo:

  1. La lógica de negocio ya está resuelta
  2. El adapter es principalmente adaptación de contrato + validación de auth legacy
  3. Control de saldo (verificar que la compañía tenga geocoding habilitado) debe preservarse del flujo original