globalmapper.GetAreaFeatureEx
=============================

.. currentmodule:: globalmapper
.. py:function:: GetAreaFeatureEx (GM_LayerHandle_t32 aLayer, uint32 aAreaIndex, GM_GetFeatureFlags_t32 aFlags, int aReserved) -> GM_AreaFeature_t

    Returns the area feature at the given index in the layer. Returns 0 if the layer does not contain an area at the
    given index or if a registration key was not found and aAreaIndex was greater than GM_MAX_NON_REGISTERED_VECTOR_IDX.

    Using the *aFlags* parameter you can control whether the coordinates for the features are returned in the native
    projection of the layer or in the current set projection. You can also indicate that you don't want the coordinates
    at all.

    Any features returned from this function must be freed using a call to
    :doc:`FreeAreaFeature<globalmapper.FreeAreaFeature>` when you are done accessing the feature.

    :param GM_LayerHandle_t32 aLayer: Layer to get area from
    :param uint32 aAreaIndex: Index of area feature to retrieve
    :param GM_GetFeatureFlags_t32 aFlags: Flags for getting feature
    :param int aReserved: Reserved for future use; must be 0.
    :returns: The area feature at index *aAreaIndex* within *aLayer*
    :rtype: GM_AreaFeature_t