dtoolkit.geoaccessor.geoseries.reverse_geocode#

dtoolkit.geoaccessor.geoseries.reverse_geocode(s: GeoSeries, /, **kwargs) GeoDataFrame[source]#

Reverse geocode Point type GeoSeries and get the corresponding addresses.

Parameters
**kwargs

See the documentation for reverse_geocode() for complete details on the keyword arguments.

Returns
GeoDataFrame
Raises
ModuleNotFoundError

If don’t have module named ‘geopy’.

Examples

>>> import dtoolkit.geoaccessor
>>> import pandas as pd
>>> df = (
...     pd.Series(
...         [
...             "POINT (-71.0594869 42.3584697)",
...             "POINT (-77.0365305 38.8977332)",
...         ],
...         name="wkt",
...     )
...     .from_wkt(crs=4326)
...     .geometry
...     .to_frame("geometry")
... )
>>> df
                     geometry
0  POINT (-71.05949 42.35847)
1  POINT (-77.03653 38.89773)
>>> df.reverse_geocode()
                     geometry                                            address
0  POINT (-71.05977 42.35860)  18-32, Tremont Street, 02108, Tremont Street, ...
1  POINT (-77.03655 38.89772)  Pennsylvania Avenue Northwest, 20006, Pennsylv...