deprecate buffer_dist and clean_periphery arguments

[gboeing]

This PR:

• deprecates the buffer_dist function parameter in the graph, features, and geocoder modules. It is seldom used, it clutters the codebase, and its functionality is easily reproduced by the user with ~1 line of code.
• deprecates the clean_periphery function parameter in the graph module: the equivalent of clean_periphery=True will the the uniform behavior going forward. This is the only way to generate an accurate graph on the perimeter, and the only way to get accurate stats, so it really makes no sense to have a False option here. See also (fix bug: streets per node is not calculated when clean_periphery=False #775).
• updates the docs with some explanatory details regarding (now-standard) periphery cleaning

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.73%. Comparing base (a3aefcc) to head (b8407ca).
Report is 804 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1044      +/-   ##
==========================================
+ Coverage   97.71%   97.73%   +0.01%     
==========================================
  Files          26       26              
  Lines        2456     2467      +11     
==========================================
+ Hits         2400     2411      +11     
  Misses         56       56              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[EwoutH]

• its functionality is easily reproduced by the user with ~1 line of code.

What would be the proper way to replace buffer_dist? (in this case with graph_from_place)

Edit: Would that be this example? Or can it be done more elegantly?

# or get the walking network within a 500 meter buffer of piedmont
polygon = ox.geocode_to_gdf("Piedmont, California, USA").loc[0, "geometry"]
poly_proj, crs_proj = ox.projection.project_geometry(polygon)
polygon, _ = ox.projection.project_geometry(poly_proj.buffer(500), crs=crs_proj, to_latlong=True)
G = ox.graph_from_polygon(polygon, network_type="walk")

[gboeing]

Yes that example does the job. My initial comment was overly conservative... it takes ~3 lines of code. Though it could be a single line of code for simpler use cases.

[gboeing]

See also the new buffer_geometry helper function added in #1214.