globalmapper.FindFeaturesInArea

globalmapper.FindFeaturesInArea([GM_LayerHandle_t32] aLayerList, GM_FindFlags_t32 aFindFlags, GM_AreaFeature_t aAreaToSearch, GM_Projection_t aAreaProj, uint32 aReserved=0) → GM_Error_t32, GM_FoundFeatureResults_t[source]

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 a GM_FoundFeatureResults_t list. After you are done with it, use FreeFeatureResultList to free the result list.

Parameters:

  • aLayerList ([GM_LayerHandle_t32]) – List of layers to search for points or None for all vector layers

  • aFindFlags (GM_FindFlags_t32) – Flags controlling how the find is performed

  • aAreaToSearch (GM_AreaFeature_t) – Area feature to search (use GetAreaFeature to get from loaded layer)

  • aAreaProj (GM_Projection_t) – Projection of coordinates in area feature (use GetLayerInfo().mNativeProj to get layer projection)

  • aReserved (uint32) – Reserved for future use; defaults to 0

Returns:

Error Code

Return type:

GM_Error_t32

Returns:

Results of find operation (use FreeFeatureResultList to free when done)

Return type:

GM_FoundFeatureResults_t