This method's name is a historical artifact - it was originally intended to retrieve all buildings associated with a user ID. It has evolved to allow many more filter options, and retrieves a small snippet of information related to each building matching the filter, and to its child and ancestor buildings. The retrieve_* methods can then be used to get more complete information about the buildings if desired.
This method returns a collection of buildings_by_id_result elements, each of which contains the following:
Method access is limited by the roles assigned the user to whom the session token was assigned