Google Maps

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

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Google Maps

Prerequisites

Example

Toolkit Params

Toolkit Functions

Rate Limits

Developer Resources

​Prerequisites

​Example

​Toolkit Params

​Toolkit Functions

​Rate Limits

​Developer Resources

Prerequisites

Example

Toolkit Params

Toolkit Functions

Rate Limits

Developer Resources