GM_FindFeaturesInArea – Global Mapper

Global Mapper SDK

Searches the provided list of layers for any visible vector features within the provided area feature. You can find area, line, and/or point features that are completely within the provided area feature.

The results are returned in the aResultList value. After you are done with the result list, use GM_FreeFeatureResultList to free the result list.

Syntax

C++

Copy

GM_DLL_EXPORTED GM_Error_t32 __stdcall GM_FindFeaturesInArea
    (
    GM_LayerHandle_t32*         aLayerList,         // IN: List of layers to search for points or NULL for all vector layers
    uint32                      aLayerCount,        // IN: Number of layers in list (0 for all)
    GM_FindFlags_t32            aFindFlags,         // IN: Flags controlling how the find is performed
    const GM_AreaFeature_t*     aAreaToSearch,      // IN: Area feature to search (use GM_GetAreaFeature to get from loaded layer)
    const GM_Projection_t*      aAreaProj,          // IN: Projection of coordinates in area feature (use GM_GetLayerInfo()->mNativeProj to get layer projection)
    GM_FoundFeatureResults_t*   aResultList,        // OUT: Results of find operation (use GM_FreeFeatureResultList to free when done)
    void*                       aReserved           // IN: Reserved for future use, must be NULL
    );