Added Google Maps toolkit.

[gauravdhiman]

Description

Please include:

• Summary of changes: Added set of tools to work with Google Maps.
• Related issues: NA
• Motivation and context: Currently there are no toolset for google maps in phidata as, so adding the same.
• Environment or dependencies: NA
• Impact on AI/ML components: NA

Fixes # (issue)

Type of change

Please check the options that are relevant:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Model update
• Infrastructure change

Checklist

• My code follows Phidata's style guidelines and best practices
• I have performed a self-review of my code
• I have added docstrings and comments for complex logic
• My changes generate no new warnings or errors
• I have added cookbook examples for my new addition (if needed)
• I have updated requirements.txt/pyproject.toml (if needed)
• I have verified my changes in a clean environment

Additional Notes

Tested with below test script:

"""
Busines info agent that can search google maps for business listings and then search their respective websites to get more info before presenting to user.
"""
"""
Business Contact Search Agent for finding and extracting business contact information.
"""
import sys
import os
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))

from phi.agent import Agent
from dotenv import load_dotenv
load_dotenv()

from phi.model.openrouter import OpenRouter
from phi.tools.crawl4ai_tools import Crawl4aiTools
from phi.tools.google_map_tools import GoogleMapTools

def create_agent():
    """Create and return the Business Contact Search Agent"""
    return Agent(
        name="business_contact_search",
        model=OpenRouter(id="deepseek/deepseek-chat"),
        tools=[
            GoogleMapTools(),  # For searching businesses on Google Maps
            Crawl4aiTools(max_length=5000),  # For scraping business websites
        ],
        description="You are a business contact information researcher specializing in finding accurate contact details for businesses.",
        instructions=[
            "When given a search query to find business contact information:",
            "Use the Google Maps Search tool to find relevant businesses in the specified location.",
            "For each business found by Google Maps Search tool, if they have a website, use web crawler tool to extract other business information.",
            "Whatever information you dont get from google maps, try to get it from website.",
        ],
        markdown=True,
        show_tool_calls=True,
        debug_mode=True,
    )

# Test the agent if run directly
if __name__ == "__main__":
    agent = create_agent()
    agent.print_response(
        "get me the business name, website, email and phone numbers of 2 indian restaurants in phoenix AZ",
        markdown=True,
        stream=True
    )

Here is the output:

[manthanguptaa]

move this into a try and catch block. Take inspiration from here https://github.com/phidatahq/phidata/blob/main/phi/tools/slack.py#L8

[manthanguptaa]

move this inside the class in __init__ function and also a check if the key is set or not else raise an error

[manthanguptaa]

Is this function only for search businesses? If yes then we should either make it generalised to find any place on the map else rename the function to search_businesses_google_maps. What do you think?