geopandas.GeoSeries.overlaps

GeoSeries.overlaps(other, align=None)

对于所有与other重叠的对齐几何体返回True，否则返回False。

如果几何体有超过一个但不是所有的公共点，具有相同的维度，并且几何体内部的交集与几何体本身具有相同的维度，则它们是重叠的。

该操作以一对一的行方式进行：

Parameters:

otherGeoSeries or geometric object

要测试是否重叠的GeoSeries（逐元素）或几何对象。

alignbool | None (default None)

如果为真，则根据其索引自动对齐GeoSeries。 如果为假，则保留元素的顺序。 None默认为真。

Returns:

Series (bool)

另请参阅

GeoSeries.crosses

GeoSeries.intersects

笔记

该方法按行方式工作。它不检查一个GeoSeries的一个元素是否与另一个GeoSeries的overlaps 任何元素重叠。

示例

>>> from shapely.geometry import Polygon, LineString, MultiPoint, Point
>>> s = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         LineString([(0, 0), (2, 2)]),
...         MultiPoint([(0, 0), (0, 1)]),
...     ],
... )
>>> s2 = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (2, 0), (0, 2)]),
...         LineString([(0, 1), (1, 1)]),
...         LineString([(1, 1), (3, 3)]),
...         Point(0, 1),
...     ],
...     index=range(1, 5),
... )

>>> s
0    POLYGON ((0 0, 2 2, 0 2, 0 0))
1    POLYGON ((0 0, 2 2, 0 2, 0 0))
2             LINESTRING (0 0, 2 2)
3         MULTIPOINT ((0 0), (0 1))
dtype: geometry

>>> s2
1    POLYGON ((0 0, 2 0, 0 2, 0 0))
2             LINESTRING (0 1, 1 1)
3             LINESTRING (1 1, 3 3)
4                       POINT (0 1)
dtype: geometry

我们可以检查每个GeoSeries的几何图形是否与单个几何图形相交：

>>> polygon = Polygon([(0, 0), (1, 0), (1, 1), (0, 1)])
>>> s.overlaps(polygon)
0     True
1     True
2    False
3    False
dtype: bool

我们还可以逐行检查两个GeoSeries。 上面的GeoSeries具有不同的索引。我们可以基于索引值对两个GeoSeries进行对齐，并使用相同索引比较元素，使用 align=True，或者忽略索引并根据它们的匹配顺序比较元素，使用 align=False:

>>> s.overlaps(s2)
0    False
1     True
2    False
3    False
4    False
dtype: bool

>>> s.overlaps(s2, align=False)
0     True
1    False
2     True
3    False
dtype: bool