globalmapper.GetAreaFeature
===========================

.. currentmodule:: globalmapper
.. py:function:: GetAreaFeature (GM_LayerHandle_t32 aLayer, uint32 aAreaIndex) -> 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.

    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
    :returns: The area feature at index *aAreaIndex* within *aLayer*
    :rtype: GM_AreaFeature_t