Of course, this still doesn’t answer questions about how far the search radius extends around the supplied point, or whether searching for “Bar” would bring up different results than “Pub”…. The Bing Maps SOAP Search Service | Alastair Aitchison
How to Write a Self-Documenting API URLs and REST resources have to be intuitive. The API should cross-link with URL between different resources. This is used very aggressively in the API. I feel that JSON is better for self-documenting than XML and that the world is moving to JSON so the API is JSON only….