GeoDataFrame.shortest_line

Returns the shortest line between each geometry in the GeoSeries and other. The resulting line starts on this geometry and ends on other. The operation works on a 1-to-1 row-wise manner:

Signature

shortest_line(other, align=None)

Parameters

GeoSeries or geometric object

required

The GeoSeries (elementwise) or geometric object to find the shortest line to.

bool | None (default None)

default:"None"

If True, automatically aligns GeoSeries based on their indices. None defaults to True. If False, the order of elements is preserved.

Returns

GeoSeries

Examples

>>> from sedona.spark.geopandas import GeoSeries
>>> from shapely.geometry import Point, LineString
>>> s1 = GeoSeries(
...     [
...         Point(0, 0),
...         LineString([(0, 0), (1, 0)]),
...     ]
... )
>>> s2 = GeoSeries(
...     [
...         Point(1, 1),
...         Point(0, 1),
...     ]
... )
>>> s1.shortest_line(s2, align=False)
0    LINESTRING (0 0, 1 1)
1    LINESTRING (0 0, 0 1)
dtype: geometry

​Signature

​Parameters

​Returns

​Examples

Signature

Parameters

Returns

Examples