GeoSeries.get_geometry

Returns the n-th geometry from a collection of geometries (0-indexed). If the index is non-negative, it returns the geometry at that index. If the index is negative, it counts backward from the end of the collection (e.g., -1 returns the last geometry). Returns None if the index is out of bounds. Note: Simple geometries act as length-1 collections Note: Using Shapely < 2.0, may lead to different results for empty simple geometries due to how shapely interprets them.

Signature

get_geometry(index) -> GeoSeries

Parameters

int or array_like

required

Position of a geometry to be retrieved within its collection

Returns

GeoSeries

Simple geometries act as collections of length 1. Any out-of-range index value returns None.

Examples

>>> from shapely.geometry import Point, MultiPoint, GeometryCollection
>>> s = geopandas.GeoSeries(
...     [
...         Point(0, 0),
...         MultiPoint([(0, 0), (1, 1), (0, 1), (1, 0)]),
...         GeometryCollection(
...             [MultiPoint([(0, 0), (1, 1), (0, 1), (1, 0)]), Point(0, 1)]
...         ),
...         Polygon(),
...         GeometryCollection(),
...     ]
... )
>>> s
0                                          POINT (0 0)
1              MULTIPOINT ((0 0), (1 1), (0 1), (1 0))
2    GEOMETRYCOLLECTION (MULTIPOINT ((0 0), (1 1), ...
3                                        POLYGON EMPTY
4                             GEOMETRYCOLLECTION EMPTY
dtype: geometry

>>> s.get_geometry(0)
                              POINT (0 0)
                              POINT (0 0)
  MULTIPOINT ((0 0), (1 1), (0 1), (1 0))
                            POLYGON EMPTY
                                     None
dtype: geometry

>>> s.get_geometry(1)
         None
  POINT (1 1)
  POINT (0 1)
         None
         None
dtype: geometry

>>> s.get_geometry(-1)
  POINT (0 0)
  POINT (1 0)
  POINT (0 1)
POLYGON EMPTY
         None
dtype: geometry

​Signature

​Parameters

​Returns

​Examples

Signature

Parameters

Returns

Examples