CalcDistance method (Element)

Возвращает расстояние в метрах от объекта до другого объекта или точки.

Применяется к:

Element

Синтаксис:

Visual Basic:

Function CalcDistance(inObject As Object, eMeasure As eMeasureType) As Double

inObject - объект, до которого измеряется расстояние: Element, ZPoint, PolyLine, PolyPolyLine, Contour или PolyContour.

eMeasure - способ вычисления: eMeasureTypeCartesian (0) - на плоскости, eMeasureTypeSpherical (1) - на сфероиде, eMeasureTypeRaw (2) - по координатам слоя без пересчета.

Описание:

Расстояние измеряется между ближайшими точками объектов, а не между их точками привязки. Если точка лежит внутри площадного объекта, расстояние равно 0. Координаты точки, ломаной и контура задаются в системе координат слоя, которому принадлежит объект.

Результат - в метрах при любых единицах координат слоя. У слоя в широте и долготе расстояние на сфероиде дает только eMeasureTypeSpherical: при eMeasureTypeCartesian и eMeasureTypeRaw градус долготы считается равным градусу широты, и расстояние вдоль параллели завышено. У слоя в проекции и у план-схемы способ вычисления на результат практически не влияет.

Если inObject - объект другого класса или Nothing, метод возвращает 0 без ошибки.

Пример:

Пример сообщает расстояние между первым и последним объектами активного слоя.

Visual Basic:

Sub Element_CalcDistance
Const eMeasureTypeSpherical = 1
'Берем активный слой карты, его первый и последний объекты
Set L = Zulu.ActiveMapDoc.Layers.Active
Set K = L.ElementKeys
Set E1 = L.Elements.Item(K.Item(1))
Set E2 = L.Elements.Item(K.Item(K.Count))
'Расстояние на сфероиде годится для слоя с любыми координатами
D = E1.CalcDistance(E2, eMeasureTypeSpherical)
MsgBox "От объекта " & E1.Key & " до объекта " & E2.Key & ": " & D & " м"
End Sub

Python:

import zulu

eMeasureTypeSpherical = 1

def Macro_Element_CalcDistance():
    # Берем активный слой карты, его первый и последний объекты
    L = zulu.App.ActiveMapDoc.Layers.Active
    K = L.ElementKeys
    E1 = L.Elements.Item(K.Item(1))
    E2 = L.Elements.Item(K.Item(K.Count))
    # Расстояние на сфероиде годится для слоя с любыми координатами
    d = E1.CalcDistance(E2, eMeasureTypeSpherical)
    print("От объекта", E1.Key, "до объекта", E2.Key, ":", d, "м")