Change the methods to access the Map elements to support error handling.

[edoren]

As discussed in the issue #11 the idea is that the new API allow the user manage and debug the errors easily.