> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wherobots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GeoSeries.buffer

> Returns a GeoSeries with all geometries buffered by the specified distance.

Returns a GeoSeries with all geometries buffered by the specified distance.

## Signature

```python theme={"system"}
buffer(
    distance,
    resolution=16,
    cap_style='round',
    join_style='round',
    mitre_limit=5.0,
    single_sided=False,
    **kwargs,
) -> GeoSeries
```

## Parameters

<ParamField path="distance" type="float" required>
  The distance to buffer by. Negative distances will create inward buffers.
</ParamField>

<ParamField path="resolution" type="int" default="16">
  The resolution of the buffer around each vertex. Specifies the number of
  linear segments in a quarter circle in the approximation of circular arcs.
</ParamField>

<ParamField path="cap_style" type="str" default="'round'">
  The style of the buffer cap. One of 'round', 'flat', 'square'.
</ParamField>

<ParamField path="join_style" type="str" default="'round'">
  The style of the buffer join. One of 'round', 'mitre', 'bevel'.
</ParamField>

<ParamField path="mitre_limit" type="float" default="5.0">
  The mitre limit ratio for joins when join\_style='mitre'.
</ParamField>

<ParamField path="single_sided" type="bool" default="False">
  Whether to create a single-sided buffer. In Sedona, True will default to left-sided buffer.
  However, 'right' may be specified to use a right-sided buffer.
</ParamField>

<ParamField path="kwargs" />

## Returns

<ResponseField name="return" type="GeoSeries">
  A new GeoSeries with buffered geometries.
</ResponseField>

## Examples

```python theme={"system"}
>>> from shapely.geometry import Point
>>> from sedona.spark.geopandas import GeoDataFrame
>>>
>>> data = {
...     'geometry': [Point(0, 0), Point(1, 1)],
...     'value': [1, 2]
... }
>>> gdf = GeoDataFrame(data)
>>> buffered = gdf.buffer(0.5)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.