Skip to content
ajan.io

Docs menu

On this page

Google Maps

Connect Google Maps to ajan to search places, geocode addresses, and get directions from your conversations

Overview

Google Maps provides location services including place search, geocoding, and directions. Once connected, you can use ajan to find places, convert addresses to coordinates, and compute routes directly from your conversations.

Prerequisites

  • A Google Cloud project with billing enabled
  • The following APIs enabled in your project:
    • Places API
    • Geocoding API
    • Directions API
    • Distance Matrix API

Setup

Enable the required APIs and create an API key

Follow Google's guide to getting an API key to enable the required APIs (Places, Geocoding, Directions, Distance Matrix) and create a key in Google Cloud Console.

In the API key settings, restrict it to the four APIs listed above to limit its scope.

Go to Integrations and find Google Maps in the list.

Enter your API key

Paste the API key and save.

Start using Google Maps in ajan

Tag the integration with @ in any agent to search places, geocode addresses, or get directions.

Common Use Cases

  • Place Search β€” Find businesses, restaurants, or points of interest near a location using natural language
  • Geocoding β€” Convert street addresses to coordinates or coordinates back to readable addresses
  • Directions β€” Get routes between locations with support for driving, walking, cycling, and transit
  • Distance Matrix β€” Calculate travel time and distance between multiple origins and destinations

Troubleshooting

IssueSolution
API key invalidVerify the key is correct and the required APIs are enabled in Google Cloud Console
Request deniedCheck that billing is enabled on your Google Cloud project
API not enabledGo to Google Cloud Console β†’ APIs & Services β†’ Library and enable the missing API
Quota exceededReview your usage limits in Google Cloud Console and increase if needed