added units option in request, updated javadoc