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 ‘geocodefarm’ with a rate limit applied (see the geocodefarm terms of service at: https://geocode.farm/geocoding/free-api-documentation/ ).

Either the string name used by geopy (as specified in geopy.geocoders.SERVICE_TO_GEOCODER) or a geopy Geocoder instance (e.g., geopy.geocoders.GeocodeFarm) 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

>>> df = reverse_geocode([Point(-71.0594869, 42.3584697),
                          Point(-77.0365305, 38.8977332)])
>>> df
                                         address  \
0             29 Court Square, Boston, MA 02108, USA
1  1600 Pennsylvania Avenue Northwest, President'...
                         geometry
0  POINT (-71.0594869 42.3584697)
1  POINT (-77.0365305 38.8977332)

geopandas.tools.geocode geopandas.tools.collect