Add tool to get coordinates of a city from an API

app.py

@@ -4,19 +4,55 @@ import requests
 import pytz
 import yaml
 from tools.final_answer import FinalAnswerTool
+from typing import List, Dict, Union
+import time
+
 
 from Gradio_UI import GradioUI
 
 # Below is an example of a tool that does nothing. Amaze us with your creativity !
 @tool
-def my_custom_tool(arg1:str, arg2:int)-> str: #it's import to specify the return type
+def get_city_coordinates(city_name: str, country_code: str = None) -> List[Dict[str, Union[str, float]]]:
     #Keep this format for the description / args / args description but feel free to modify the tool
-    """A tool that does nothing yet 
+    """
+    A tool that retrieves geographical coordinates and location details for a given city using Nominatim API.
+
+    The function queries OpenStreetMap's Nominatim service to get location data.
+    It includes a 1-second delay to respect API rate limits and returns multiple matches if found.
+
     Args:
-        arg1: the first argument
-        arg2: the second argument
+        city_name: Name of the city to search for
+        country_code: Optional two-letter country code (ISO 3166-1 alpha-2) to filter results
     """
-    return "What magic will you build ?"
+    time.sleep(1)  # Rate limiting
+    
+    params = {
+        'q': city_name,
+        'format': 'json',
+        'addressdetails': 1,
+        'countrycodes': country_code if country_code else None
+    }
+    
+    try:
+        response = requests.get(
+            "https://nominatim.openstreetmap.org/search",
+            params={k: v for k, v in params.items() if v is not None},
+            headers={'User-Agent': 'MyGeocodingApp/1.0'}
+        )
+        response.raise_for_status()
+        
+        return [{
+            'name': city_name,
+            'latitude': float(result['lat']),
+            'longitude': float(result['lon']),
+            'country': result['address'].get('country', 'Unknown'),
+            'state': result['address'].get('state', 'Unknown'),
+            'type': result['type']
+        } for result in response.json()]
+        
+    except requests.exceptions.RequestException as e:
+        print(f"Error fetching coordinates: {e}")
+        return []
 
 @tool
 def get_current_time_in_timezone(timezone: str) -> str:
@@ -55,7 +91,7 @@ with open("prompts.yaml", 'r') as stream:
     
 agent = CodeAgent(
     model=model,
-    tools=[final_answer], ## add your tools here (don't remove final answer)
+    tools=[get_city_coordinates, get_current_time_in_timezone, final_answer], ## add your tools here (don't remove final answer)
     max_steps=6,
     verbosity_level=1,
     grammar=None,