added units example to docs

A few of the coders on our project spent a while banging our head against this, trying to figure out how to pass units in to the "near" method.  I've added a doc example showing it, since it seems like something that might be quite often needed.  If other params can be passed -- apart from the API-specific ones I mean -- it might be good to show a more generalised example of how they are passed.