XPLMLookupObjects

XPLM_API int        XPLMLookupObjects(
                         const char *         inPath,    
                         float                inLatitude,    
                         float                inLongitude,    
                         XPLMLibraryEnumerator_f enumerator,    
                         void *               ref);    

This routine looks up a virtual path in the library system and returns all matching elements. You provide a callback - one virtual path may match many objects in the library. XPLMLookupObjects returns the number of objects found.

The latitude and longitude parameters specify the location the object will be used. The library system allows for scenery packages to only provide objects to certain local locations. Only objects that are allowed at the latitude/longitude you provide will be returned.