globalmapper.DistanceInit
=========================

.. currentmodule:: globalmapper
.. py:function:: DistanceInit () -> GM_Distance_t

    Initializes an empty GM_Distance_t object, which consists of a floating point distance value (*mDistance*) and a GM
    UNIT (*mUnits*) to define a distance in units. When initialized with this function, a GM_Distance_t will have
    default values of *mDistance* = 0 and *mUnits* = GM_PRJ_UNIT_UNKNOWN = -1.

    :return: The newly-created distance object
    :rtype: GM_Distance_t