Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Google Maps API

Give your agents access to Google Maps API. Bring your own Google Maps key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Google Maps

Instant

Google Maps is a leading mapping and geolocation service for finding locations, routes, and businesses worldwide. It helps users access real-time navigation, geocoding, and mapping data for seamless location-based experiences.

20 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Google Maps without a separate account or API key for each one. New accounts start with $2 of free credit.

No Google Maps account or key

Your agent calls Google Maps through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.032 per request; selected fields may increase the price to $0.035, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Google Maps with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Google Maps API to your AI assistant

Use Google Maps from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use Google Maps through Composio Instant to search for "coffee shops in New York". Return the name and address for up to three results.

What success looks like

GOOGLE_MAPS_TEXT_SEARCH

Your assistant runs Google Maps and replies with the names and addresses of up to three coffee shops in New York.

Runs on Composio Instant

SDK

Use the Google Maps API in your code

Call Google Maps from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
GOOGLE_MAPS_TEXT_SEARCH
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["google_maps"],
    instant={
        "toolkits": {"enable": ["google_maps"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "GOOGLE_MAPS_TEXT_SEARCH",
    arguments={
        "textQuery": "coffee shops in New York",
        "maxResultCount": 3,
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["google_maps"],
  instant: {
    toolkits: { enable: ["google_maps"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "GOOGLE_MAPS_TEXT_SEARCH",
  {
    "textQuery": "coffee shops in New York",
    "maxResultCount": 3
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": {
    "places": [
      {
        "displayName": "<place name>",
        "formattedAddress": "<place address>"
      }
    ]
  },
  "error": null,
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Google Maps API tools

17 Google Maps tools run on Instant, priced per call with no Google Maps key. Tools marked Your key need your own Google Maps account.

Action	Tool slug	What it does	Availability
Search Places	GOOGLE_MAPS_TEXT_SEARCH	Find places on Google Maps from a text query.	Instant$0.032 per request; selected fields may increase the price to $0.035
Search Nearby	GOOGLE_MAPS_NEARBY_SEARCH	Find places within a circular area and filter by place type.	Instant$0.032 per request; selected fields may increase the price to $0.035
Plan Route	GOOGLE_MAPS_GET_ROUTE	Calculate one or more routes between two locations.	Instant$0.010 per request; routing options may change the price to $0.005 or $0.015
Geocode Location	GOOGLE_MAPS_GEOCODING_API	Convert an address or Place ID to coordinates, or coordinates to an address.	Instant$0.005 per supported geocoding request
Get Place Details	GOOGLE_MAPS_GET_PLACE_DETAILS	Retrieve details for a place by its Place ID or resource name.	Instant$0.017 per request; selected fields may increase the price to $0.020
Autocomplete Place Predictions	GOOGLE_MAPS_AUTOCOMPLETE	Returns place and query predictions for text input.	Instant$0.00283 per request
Compute Route Matrix	GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX	Calculates travel distance and duration matrices between multiple origins and destinations using the Routes API, with various travel modes and OAuth2 support; some connections limit requests to 100 origin-destination pairs.	Instant$0.010 per origin-destination pair ($0.005–$0.015 by options); max 100 pairs.
Create Tiles Session	GOOGLE_MAPS_TILES_CREATE_SESSION	Creates a session token for 2D map tiles or Street View imagery, reusable for subsequent tile requests within its validity window.	Instant$0 per map-tile session creation; tile requests priced separately
Geocode Address With Query	GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERY	Tool to map addresses to geographic coordinates with query parameter.	Instant$0.005 per address geocoding request
Geocode Place by ID	GOOGLE_MAPS_GEOCODE_PLACE	Tool to perform geocode lookup using a place identifier to retrieve address and coordinates.	Instant$0.005 per place geocoding request
Geolocate Device	GOOGLE_MAPS_GEOLOCATE	Estimate a device's geographic location from cell tower and WiFi observations.	Instant$0.005 per device geolocation request; IP fallback unavailable
Get 2D Map Tile	GOOGLE_MAPS_GET2D_TILE	Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations.	Instant$0.0006 per returned 2D map tile
Get 3D Tiles Root	GOOGLE_MAPS_GET3D_TILES_ROOT	Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering.	Instant$0.006 per 3D root request
Get Place Photo	GOOGLE_MAPS_PLACE_PHOTO	Retrieves high quality photographic content from the Google Maps Places database.	Instant$0.007 per New API photo request; discovery calls priced separately
Get Time Zone	GOOGLE_MAPS_GET_TIME_ZONE	Retrieves time zone information for a specific geographic location and timestamp.	Instant$0.005 per time zone request
Lookup Aerial Video	GOOGLE_MAPS_LOOKUP_AERIAL_VIDEO	Tool to look up an aerial view video by address or video ID.	Instant$0.016 per ready aerial-video lookup; processing status checks are free
Reverse Geocode Location	GOOGLE_MAPS_GEOCODE_LOCATION	Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding.	Instant$0.005 per reverse geocoding request
Look Up Destination	GOOGLE_MAPS_GEOCODE_DESTINATIONS	Find a destination and its places, landmarks, entrances, and navigation points.	Your key
Embed Map	GOOGLE_MAPS_MAPS_EMBED_API	Generate a Google Maps Embed URL and iframe code for a place or route.	Your key

Instant prices are Google Maps's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Google Maps API use cases and example prompts

Copy a prompt into your agent. Each one uses Google Maps with apps you connect through Composio.

Map coffee shops for a market brief
Use Google Maps to find coffee shops near each location in my Market Areas sheet in Google Sheets. Add the places you find to the sheet, grouped by area. Post a summary in Slack's #market-research channel for our coffee shop team.
Apps used: Google Maps, Google Sheets, Slack
Plan hardware store site visits
Use Google Maps to calculate routes from our regional office to each hardware store in my Site Visits sheet in Google Sheets. Add the route results to the sheet, then write a visit brief in Google Docs for our hardware store team.
Apps used: Google Maps, Google Sheets, Google Docs
Research coffee shop prospects
Acme sells equipment to coffee shops. Use Google Maps to find coffee shops near the service area in the Acme company record in HubSpot, and add the places you find to a note on that record. Draft a Gmail outreach template for my sales team to review.
Apps used: Google Maps, HubSpot, Gmail
Build a coworking area guide
Use Google Maps to find restaurants and other places near each of my coworking spaces. Create a page in my Coworking Operations workspace in Notion with the results grouped by location, for our coworking team to share with members.
Apps used: Google Maps, Notion

TROUBLESHOOTING

Google Maps API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Use GOOGLE_MAPS_TEXT_SEARCH to find the place, then pass its Place ID in name to GOOGLE_MAPS_GET_PLACE_DETAILS.

Set routing_preference to TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL in GOOGLE_MAPS_GET_ROUTE.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Google Maps account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

Start with Google Maps.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Maps tool your agent needs.Free to start.

Start building

Google Maps API

What is Composio Instant?

No Google Maps account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Google Maps API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Google Maps API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Google Maps API tools

Google Maps API use cases and example prompts

Map coffee shops for a market brief

Plan hardware store site visits

Research coffee shop prospects

Build a coworking area guide

Google Maps API troubleshooting

Place details returns an error for a business name

A route does not account for traffic

An action asks you to connect Google Maps

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Firecrawl

Tavily

Exa

Serpapi

Start with Google Maps.It takes 30 seconds.