added getting geolocation tutorial

Author: x4nth055

README.md

@@ -68,6 +68,7 @@ This is a repository of all the tutorials of [The Python Code](https://www.thepy
     - [How to Convert Python Files into Executables](https://www.thepythoncode.com/article/building-python-files-into-stand-alone-executables-using-pyinstaller)
     - [How to Get the Size of Directories in Python](https://www.thepythoncode.com/article/get-directory-size-in-bytes-using-python). ([code](general/calculate-directory-size))
     - [How to Play and Record Audio in Python](https://www.thepythoncode.com/article/play-and-record-audio-sound-in-python). ([code](general/recording-and-playing-audio))
+    - [How to Get Geographic Locations in Python](https://www.thepythoncode.com/article/get-geolocation-in-python). ([code](general/geolocation))
 
 
 - ### [Web Scraping](https://www.thepythoncode.com/topic/web-scraping)

general/geolocation/README.md

@@ -0,0 +1 @@
+# [How to Get Geographic Locations in Python](https://www.thepythoncode.com/article/get-geolocation-in-python)

general/geolocation/geolocator.py

@@ -0,0 +1,28 @@
+from geopy.geocoders import Nominatim
+import time
+from pprint import pprint
+
+# instantiate a new Nominatim client
+app = Nominatim(user_agent="tutorial")
+# get location raw data
+location = app.geocode("Nairobi, Kenya").raw
+# print raw data
+pprint(location)
+
+
+def get_location_by_address(address):
+    """This function returns a location as raw from an address
+    will repeat until success"""
+    time.sleep(1)
+    try:
+        return app.geocode(address).raw
+    except:
+        return get_location_by_address(address)
+
+address = "Makai Road, Masaki, Dar es Salaam, Tanzania"
+location = get_location_by_address(address)
+latitude = location["lat"]
+longitude = location["lon"]
+print(f"{latitude}, {longitude}")
+# print all returned data
+pprint(location)

general/geolocation/requirements.txt

@@ -0,0 +1 @@
+geopy

general/geolocation/reverse_geolocator.py

@@ -0,0 +1,25 @@
+from geopy.geocoders import Nominatim
+from pprint import pprint
+import time
+
+app = Nominatim(user_agent="tutorial")
+
+def get_address_by_location(latitude, longitude, language="en"):
+    """This function returns an address as raw from a location
+    will repeat until success"""
+    # build coordinates string to pass to reverse() function
+    coordinates = f"{latitude}, {longitude}"
+    # sleep for a second to respect Usage Policy
+    time.sleep(1)
+    try:
+        return app.reverse(coordinates, language=language).raw
+    except:
+        return get_address_by_location(latitude, longitude)
+
+# define your coordinates
+latitude = 36.723
+longitude = 3.188
+# get the address info
+address = get_address_by_location(latitude, longitude)
+# print all returned data
+pprint(address)