readme fixes
adding mapping api to readme
updating readme with events and other methods explanation