FruxonDocs

Google Maps

Search places, geocode addresses, get directions, and calculate distances using Google Maps Platform

The Google Maps integration connects your agents to Google Maps Platform APIs for searching places, geocoding addresses, getting directions, and calculating distances between locations.

Prerequisites

You need:

  • Google Cloud API Key — A Google Cloud API key with the following APIs enabled:
    • Places API (New)
    • Geocoding API
    • Directions API
    • Distance Matrix API

To create an API key, go to the Google Cloud Console, create a new key, and enable the required APIs under APIs & Services > Library.

Setup

  1. Open Integrations from the sidebar
  2. Select Google Maps from the catalog
  3. Click Add Integration Config
  4. Give the config a display name (e.g., "Google Maps")
  5. Enter your API Key
  6. Save the config

Using in Your Agent

  1. Open your agent in Agent Studio and select an Agent Step
  2. Under Attached Integration Configurations, click Attach configuration and choose your config
  3. Attach Google Maps tools from the tools panel
  4. Tools are referenced as google_maps.places_search, google_maps.directions, etc.

Available Tools

ToolDescriptionAction Type
places_searchSearch for places (businesses, landmarks, addresses) by text queryReadOnly
place_detailsGet detailed info about a place by its place ID (hours, reviews, contact)ReadOnly
geocodeConvert between addresses and coordinates (forward and reverse geocoding)ReadOnly
directionsGet step-by-step route directions between two locationsReadOnly
distance_matrixCalculate travel distance and duration between multiple origins and destinationsReadOnly

On this page