geopandas.tools.reverse_geocode

geopandas.tools.reverse_geocode(points, provider=None, **kwargs)

Reverse geocode a set of points and get a GeoDataFrame of the resulting addresses.

The points

Parameters
pointslist or Series of Shapely Point objects.

x coordinate is longitude y coordinate is latitude

providerstr or geopy.geocoder (opt)

Specifies geocoding service to use. If none is provided, will use ‘photon’ (see the Photon’s terms of service at: https://photon.komoot.io).

Either the string name used by geopy (as specified in geopy.geocoders.SERVICE_TO_GEOCODER) or a geopy Geocoder instance (e.g., geopy.geocoders.Photon) may be used.

Some providers require additional arguments such as access keys See each geocoder’s specific parameters in geopy.geocoders

Notes

Ensure proper use of the results by consulting the Terms of Service for your provider.

Reverse geocoding requires geopy. Install it using ‘pip install geopy’. See also https://github.com/geopy/geopy

Examples

>>> from shapely.geometry import Point
>>> df = geopandas.tools.reverse_geocode(  
...     [Point(-71.0594869, 42.3584697), Point(-77.0365305, 38.8977332)]
... )
>>> df  
                     geometry                                            address
0  POINT (-71.05941 42.35837)       29 Court Sq, Boston, MA 02108, United States
1  POINT (-77.03641 38.89766)  1600 Pennsylvania Ave NW, Washington, DC 20006...