You can add location information to your Tweets, such as your city or precise location, from the web and via third-party applications. You always have the option to delete your Tweet location history. Learn more
So to design a new API, start from expert mental models and end-to-end workflows. The worst APIs I've seen originated from confused mental models. You can't create a simple language to specify how to do XYZ if you don't have a crystal clear understanding of XYZ.
Remember that the actual objects & signatures are pretty much an afterthought. Don't start with them. End with them.
I agree with this, except that for some cases teachability of the mental model is also important. Your users might not be experts yet.
Moreover, neither the API designers are domain experts.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.
