Added support for random endpoint

Author: anthonyjb

geouk/resources.py

@@ -37,7 +37,6 @@ def get(self, name, default=None):
         return self.__dict__['_document'].get(name, default)
 
 
-
 class Place(_BaseResource):
     """
     A place within the UK or Republic of Ireland.
@@ -46,6 +45,29 @@ class Place(_BaseResource):
     def __str__(self):
         return f'Place: {self.humanized_name}'
 
+    @classmethod
+    def random(cls, client, lat, lon, d):
+        """
+        Fetch a random place within the given distance of the center
+        (lat, lon).
+        """
+
+        # Fetch the random place
+        r = client(
+            'get',
+            'places/random',
+            params={
+                'lat': lat,
+                'lon': lon,
+                'd': d
+            }
+        )
+
+        if r:
+            return cls(client, r)
+
+        return None
+
     @classmethod
     def search(cls, client, q):
         """
@@ -77,6 +99,7 @@ def typeahead(cls, client, q):
 
         return r
 
+
 class Source(_BaseResource):
     """
     A source for the data store against a place which provides attribution for

setup.py

@@ -21,7 +21,7 @@
     # Versions should comply with PEP440.  For a discussion on single-sourcing
     # the version across setup.py and the project code, see
     # https://packaging.python.org/en/latest/single_source_version.html
-    version='0.0.4',
+    version='0.0.5',
     description=(
         'The GeoUK Python library provides a pythonic interface to the GeoUK '
         'API.',