Google Maps

GoogleMapTools search places, get directions, geocode addresses, and check elevation, timezone, and distance data through the Google Maps API.

GoogleMapTools enable an Agent to interact with various Google Maps services for location-based operations including place search, directions, geocoding, and more.

Prerequisites

The following example requires the googlemaps and google-maps-places libraries and an API key which can be obtained from the Google Cloud Console.

uv pip install googlemaps google-maps-places openai

export GOOGLE_MAPS_API_KEY=your_api_key_here

You’ll need to enable the following APIs in your Google Cloud Console:

• Places API
• Directions API
• Geocoding API
• Address Validation API
• Distance Matrix API
• Elevation API
• Time Zone API

Example

Basic usage of the Google Maps toolkit:

from agno.agent import Agent
from agno.tools.google.maps import GoogleMapTools

agent = Agent(tools=[GoogleMapTools()])
agent.print_response("Find coffee shops in San Francisco")

For more examples, see the Google Maps Tools example.

Toolkit Params

Parameter	Type	Default	Description
key	Optional[str]	None	Optional API key. If not provided, uses GOOGLE_MAPS_API_KEY environment variable
search_places	bool	True	Enable the search_places tool.
get_directions	bool	True	Enable the get_directions tool.
validate_address	bool	True	Enable the validate_address tool.
geocode_address	bool	True	Enable the geocode_address tool.
reverse_geocode	bool	True	Enable the reverse_geocode tool.
get_distance_matrix	bool	True	Enable the get_distance_matrix tool.
get_elevation	bool	True	Enable the get_elevation tool.
get_timezone	bool	True	Enable the get_timezone tool.

Toolkit Functions

Function	Description
search_places	Search for places using Google Maps Places API. Parameters: query (str) for the search query. Returns stringified JSON with place details including name, address, phone, website, rating, and hours.
get_directions	Get directions between locations. Parameters: origin (str), destination (str), optional mode (str) for travel mode, optional departure_time (datetime), optional avoid (List[str]) for features to avoid. Returns route information.
validate_address	Validate an address. Parameters: address (str), region_code (str, default "US"), optional locality (str), enable_usps_cass (bool, default False). Returns address validation results.
geocode_address	Convert address to coordinates. Parameters: address (str), optional region (str). Returns location information with coordinates.
reverse_geocode	Convert coordinates to address. Parameters: lat (float), lng (float), optional result_type and location_type (List[str]). Returns address information.
get_distance_matrix	Calculate distances between locations. Parameters: origins (List[str]), destinations (List[str]), optional mode (str), departure_time (datetime), and avoid (List[str]). Returns distance and duration matrix.
get_elevation	Get elevation for a location. Parameters: lat (float), lng (float). Returns elevation data.
get_timezone	Get timezone for a location. Parameters: lat (float), lng (float), optional timestamp (datetime). Returns timezone information.

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Rate Limits

Google Maps APIs have usage limits and quotas that vary by service and billing plan. Please refer to the Google Maps Platform pricing for details.

Developer Resources

• Tools