MI_DistanceToEdge

Description

Returns the distance between two geometries using the computation type and distance units. Specifically, the distance between two closest points of the two geometries is determined. When a geometry is inside another geometry, the shortest distance between the two geometries is returned with a positive distance value.

Syntax

MI_DistanceToEdge ( geom1, geom2, unit, calculationType)

Arguments

geom1 is an expression which returns a geometry, or a geometry construct

geom2 is an expression which returns a geometry, or a geometry construct

unit is a linear unit specification, and

calculationType is a string that indicates whether to perform a Spherical or Cartesian calculation. The default is calculated based on the coordinate system of the first geometry.

Example

Returns the distance to edge from the specified geometry to each country.

select MI_DistanceToEdge(MI_Box(-20,-20,20,20,'epsg:4326'),Obj,'mi','Spherical') as distanceToEdge from countries where country in ('Canada','Vietnam','Brazil','China','Japan')
			

Remarks

Calculates the distance between two geometries. The value returned is a double and represents a value in the units specified by the units argument.

Valid values for unit are these distance units:

Value Description
mi miles
km kilometers
in inches
ft feet
yd yards
cm centimeters
m meters