fix: mark permanently_closed as deprecated (googlemaps#365)

Author: jpoehnelt

googlemaps/places.py

@@ -100,6 +100,13 @@
     ^ PLACES_DETAIL_FIELDS_ATMOSPHERE
 )
 
+DEPRECATED_FIELDS = {"permanently_closed"}
+DEPRECATED_FIELDS_MESSAGE = (
+    "Fields, %s, are deprecated. "
+    "Read more at https://developers.google.com/maps/deprecations."
+)
+
+
 def find_place(
     client, input, input_type, fields=None, location_bias=None, language=None
 ):
@@ -143,7 +150,14 @@ def find_place(
             "the given value is invalid: '%s'" % input_type
         )
 
-    if fields:       
+    if fields:
+        deprecated_fields = set(fields) & DEPRECATED_FIELDS
+        if deprecated_fields:
+            warnings.warn(
+                DEPRECATED_FIELDS_MESSAGE % str(list(deprecated_fields)),
+                DeprecationWarning,
+            )
+
         invalid_fields = set(fields) - PLACES_FIND_FIELDS
         if invalid_fields:
             raise ValueError(
@@ -422,6 +436,13 @@ def place(client, place_id, session_token=None, fields=None, language=None):
     params = {"placeid": place_id}
 
     if fields:
+        deprecated_fields = set(fields) & DEPRECATED_FIELDS
+        if deprecated_fields:
+            warnings.warn(
+                DEPRECATED_FIELDS_MESSAGE % str(list(deprecated_fields)),
+                DeprecationWarning,
+            )
+
         invalid_fields = set(fields) - PLACES_DETAIL_FIELDS
         if invalid_fields:
             raise ValueError(