Google Maps connector for AI agents

Tools your location agent reaches for on Google Maps, scoped per user.

CALL ANY TOOL

14 tools for location data on Google Maps: search places and fetch details and photos, geocode and reverse geocode, validate addresses, snap GPS traces to roads, and compute routes.

googlemaps_address_validate

Validate address

Check and standardise a postal address, filling in missing parts and flagging components that look wrong. Returns a verdict (validation granularity, whether it's complete and whether parts were inferred or replaced), the corrected address, geocode, and USPS data for US addresses when requested, plus a responseId. Use this to verify a mailing or delivery address. Use geocode_address when you only need coordinates.

Parameters

Name

Type

Required

Description

address_lines

array

Required

The unstructured address lines, for example ["1600 Amphitheatre Pkwy", "Mountain View, CA 94043"]. You can put the whole address in one line. All address inputs together must be at most 280 characters.

administrative_area

string

Optional

State, province or region, if not already in address_lines. Example: CA.

enable_usps_cass

boolean

Optional

If true, also run USPS CASS validation (US and Puerto Rico addresses only); region_code must be US or PR. Defaults to false.

locality

string

Optional

City or town, if not already in address_lines. Example: Mountain View.

postal_code

string

Optional

Postal or ZIP code, if not already in address_lines. Example: 94043.

previous_response_id

string

Optional

The responseId from a previous validation of the same address, when re-validating after the user edits it. Leave empty for a new address.

region_code

string

Optional

Two-letter CLDR region code of the address, such as US or GB. Strongly recommended; if omitted Google infers it from the address lines.

session_token

string

Optional

Autocomplete session token to end an autocomplete session with this validation for billing. URL-safe base64, at most 36 characters.

googlemaps_geocode_address

Geocode address

googlemaps_geocode_location

Geocode location

googlemaps_geocode_place

Geocode place

googlemaps_geolocate

Geolocate

googlemaps_places_autocomplete

Places autocomplete

Get place and query suggestions for partial text as a user types, such as "pizza in new y". Returns up to five suggestions, each a place prediction (place ID, text, types, and distance if an origin is given) or a query prediction. Use this for type-ahead input. Use places_search_text for full search results. Pass a chosen place ID to places_get with the same session_token.

Parameters

Name

Type

Required

Description

input

string

Required

The partial text to complete, as typed so far. Example: "pizza in new y".

field_mask

string

Optional

Comma-separated list of response fields to return, sent as the X-Goog-FieldMask header. Optional. Leave empty to get every field. Google bills by the most expensive field requested. Example: suggestions.placePrediction.placeId,suggestions.placePrediction.text. Use "*" only for testing.

include_query_predictions

boolean

Optional

If true, the response can include query predictions (suggested search strings) as well as place predictions. Defaults to false.

included_primary_types

array

Optional

Up to five primary place types to restrict suggestions to, for example ["restaurant"], or one of the collections (regions) or (cities).

included_region_codes

array

Optional

Up to 15 two-letter region codes to restrict results to, for example ["us", "ca"].

input_offset

integer

Optional

Zero-based Unicode character offset of the cursor in input. Defaults to the length of input.

language_code

string

Optional

Preferred language for suggestions in the response, as a BCP-47 code such as en, fr or ja.

location_bias_latitude

number

Optional

Latitude in decimal degrees of the centre of a circle that results should favour. Set together with location_bias_longitude; results outside the circle can still appear.

location_bias_longitude

number

Optional

Longitude in decimal degrees of the centre of the bias circle. Set together with location_bias_latitude.

location_bias_radius_meters

number

Optional

Radius in meters of the bias circle, from 0 to 50000. Used only when location_bias_latitude and location_bias_longitude are set.

origin_latitude

number

Optional

Latitude of the origin used to calculate distanceMeters for each prediction. Set together with origin_longitude.

origin_longitude

number

Optional

Longitude of the origin used to calculate distanceMeters for each prediction. Set together with origin_latitude.

region_code

string

Optional

Two-letter CLDR/ccTLD region code that sets regional formatting and preferences, such as us, gb or in.

session_token

string

Optional

Session token that groups autocomplete calls and the final places_get call into one billing session. Use a URL-safe base64 string of at most 36 characters, such as a UUID, and reuse it until a place is selected.

googlemaps_places_get

Get places

googlemaps_places_photo_get

Get places photo

googlemaps_places_search_nearby

Places search nearby

Find places of given types inside a circle around a latitude and longitude, such as cafes within 500 meters of a point. Returns up to 20 places with the fields named in field_mask (by default id, name, address, location, types, rating and Maps link). There is no pagination. Use this when you have a coordinate and want places by type. Use places_search_text for a query in words. Use places_get for one known place.

Parameters

Name

Type

Required

Description

latitude

number

Required

Latitude in decimal degrees of the centre of the search circle. Example: 37.7937.

longitude

number

Required

Longitude in decimal degrees of the centre of the search circle. Example: -122.3965.

radius_meters

number

Required

Radius of the search circle in meters, greater than 0 and at most 50000. Only places inside the circle are returned.

excluded_primary_types

array

Optional

Primary place types to exclude (up to 50). Example: ["gas_station"].

excluded_types

array

Optional

Place types to exclude (up to 50), for example ["fast_food_restaurant"].

field_mask

string

Optional

Comma-separated list of response fields to return, sent as the X-Goog-FieldMask header. Google requires a field mask for this method and bills by the most expensive field requested. Prefix place fields with "places.", e.g. places.id,places.displayName,places.formattedAddress. Use "*" only for testing. Default: `places.id,places.displayName,places.formattedAddress,places.location,places.types,places.primaryType,places.rating,places.userRatingCount,places.googleMapsUri`.

included_primary_types

array

Optional

Primary place types to include (up to 50). Unlike included_types, a place matches only if its primary type is one of these. Example: ["italian_restaurant"].

included_types

array

Optional

Place types to include, from Google's Places (New) type table (up to 50), for example ["restaurant", "cafe"]. A place matches if it has any of these types.

language_code

string

Optional

Preferred language for names and addresses in the response, as a BCP-47 code such as en, fr or ja.

max_result_count

integer

Optional

Maximum number of places to return, from 1 to 20. Defaults to 20.

rank_preference

string

Optional

How to order results: POPULARITY (default) or DISTANCE (nearest first). One of: `POPULARITY`, `DISTANCE`.

region_code

string

Optional

Two-letter CLDR/ccTLD region code that sets regional formatting and preferences, such as us, gb or in.

googlemaps_places_search_text

Places search text

Search Google Maps for places that match a free-text query such as "pizza in New York" or "museums near Golden Gate Park". Returns up to 20 places per page with the fields named in field_mask (by default id, name, address, location, types, rating and Maps link), plus nextPageToken when more results exist. Use this for a query in words. Use places_search_nearby for places of given types around a coordinate. Use places_autocomplete for as-you-type suggestions.

Parameters

Name

Type

Required

Description

text_query

string

Required

The free-text search, as a person would type it into Google Maps. Can include a business name, category and place. Example: "vegetarian restaurants in Austin, TX".

field_mask

string

Optional

Comma-separated list of response fields to return, sent as the X-Goog-FieldMask header. Google requires a field mask and bills by the most expensive field requested. Prefix place fields with "places." and add nextPageToken to get pagination tokens. Use "*" only for testing. Example: places.id,places.displayName,places.formattedAddress,nextPageToken. Default: `places.id,places.displayName,places.formattedAddress,places.location,places.types,places.primaryType,places.rating,places.userRatingCount,places.googleMapsUri,nextPageToken`.

include_pure_service_area_businesses

boolean

Optional

If true, also return businesses that visit or deliver to customers and have no physical storefront (for example plumbers or cleaners). These results have no address or location fields. Defaults to false.

included_type

string

Optional

Restrict results to one place type from Google's Places (New) type table, for example restaurant, cafe, lodging or gas_station. Only one type is supported.

language_code

string

Optional

Preferred language for names and addresses in the results, as a BCP-47 code such as en, fr or ja. Unsupported codes fall back to English.

location_bias_latitude

number

Optional

Latitude in decimal degrees of the centre of a circle that results should favour. Set together with location_bias_longitude and location_bias_radius_meters; results outside the circle can still appear.

location_bias_longitude

number

Optional

Longitude in decimal degrees of the centre of the bias circle. Set together with location_bias_latitude and location_bias_radius_meters.

location_bias_radius_meters

number

Optional

Radius in meters of the bias circle, from 0 to 50000. Used only when location_bias_latitude and location_bias_longitude are also set.

min_rating

number

Optional

Exclude places whose average user rating is below this value. Valid values are 0 to 5 in steps of 0.5; other values round up to the next 0.5.

open_now

boolean

Optional

If true, return only places that are open at the time of the request. Defaults to false.

page_size

integer

Optional

Maximum number of places to return on this page, from 1 to 20. Defaults to 20.

page_token

string

Optional

The nextPageToken from a previous response, to fetch the next page. Every other input must match the original request. Include nextPageToken in field_mask to receive it.

price_levels

array

Optional

Restrict results to these price levels. Valid values: PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE. Example: ["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"].

rank_preference

string

Optional

How to order results: RELEVANCE (default for most queries) or DISTANCE (nearest first, best with a location bias). One of: `RELEVANCE`, `DISTANCE`.

region_code

string

Optional

Two-letter CLDR region code of where the request comes from, such as us or gb. Affects address formatting and region-specific results.

strict_type_filtering

boolean

Optional

If true, return only places whose type matches included_type exactly. Defaults to false, where included_type only biases results.

googlemaps_roads_nearest_roads

Roads nearest roads

googlemaps_roads_snap_to_roads

Roads snap to roads

googlemaps_routes_compute

Routes compute

Compute directions between an origin and a destination, with optional stops, travel mode, traffic awareness and toll, highway or ferry avoidance. Returns one or more routes with the fields named in field_mask (by default duration, distance, an encoded polyline, and turn-by-turn steps per leg). Use this for one origin and destination. Use routes_compute_matrix for travel times between many origins and destinations.

Parameters

Name

Type

Required

Description

destination

string

Required

Where the route ends. Same formats as origin.

origin

string

Required

Where the route starts. Each point can be a street address or place name ("1600 Amphitheatre Pkwy, Mountain View, CA"), a "latitude,longitude" pair ("37.4220,-122.0841"), or a Google place ID prefixed with place_id: ("place_id:ChIJj61dQgK6j4AR4GeTYWZsKWw").

arrival_time

string

Optional

Desired arrival time as an RFC 3339 UTC timestamp, TRANSIT only. Can't be combined with departure_time.

avoid_ferries

boolean

Optional

If true, avoid ferries where reasonable. DRIVE and TWO_WHEELER only.

avoid_highways

boolean

Optional

If true, avoid highways where reasonable. DRIVE and TWO_WHEELER only.

avoid_tolls

boolean

Optional

If true, avoid toll roads where reasonable. DRIVE and TWO_WHEELER only.

compute_alternative_routes

boolean

Optional

If true, also return up to two alternative routes. Not available with intermediate stops. Defaults to false.

departure_time

string

Optional

Departure time as an RFC 3339 UTC timestamp, for example 2026-11-02T15:00:00Z. Must be now or in the future (past times work only for TRANSIT). Defaults to now.

field_mask

string

Optional

Comma-separated list of response fields to return, sent as the X-Goog-FieldMask header. Google requires a field mask for this method and bills by the most expensive field requested. Prefix fields with "routes.", e.g. routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline. Use "*" only for testing. Default: `routes.duration,routes.staticDuration,routes.distanceMeters,routes.description,routes.localizedValues,routes.warnings,routes.polyline.encodedPolyline,routes.legs.duration,routes.legs.distanceMeters,routes.legs.steps.distanceMeters,routes.legs.steps.navigationInstruction,routes.optimizedIntermediateWaypointIndex`.

intermediates

array

Optional

Stops between origin and destination, in order (up to 25). Same formats as origin. Example: ["Palo Alto, CA", "37.5,-122.2"].

language_code

string

Optional

Preferred language for instructions and localized values in the response, as a BCP-47 code such as en, fr or ja.

optimize_waypoint_order

boolean

Optional

If true, reorder intermediates to minimise total travel time; the new order is in routes.optimizedIntermediateWaypointIndex. Not allowed with TRAFFIC_AWARE_OPTIMAL. Defaults to false.

region_code

string

Optional

Two-letter CLDR/ccTLD region code that sets regional formatting and preferences, such as us, gb or in.

routing_preference

string

Optional

Traffic handling, for DRIVE and TWO_WHEELER only: TRAFFIC_UNAWARE (fastest to compute, default), TRAFFIC_AWARE, or TRAFFIC_AWARE_OPTIMAL (best quality, slowest). Leave empty for other travel modes or the request fails. One of: `TRAFFIC_UNAWARE`, `TRAFFIC_AWARE`, `TRAFFIC_AWARE_OPTIMAL`.

travel_mode

string

Optional

How to travel: DRIVE (default), BICYCLE, WALK, TWO_WHEELER or TRANSIT. One of: `DRIVE`, `BICYCLE`, `WALK`, `TWO_WHEELER`, `TRANSIT`.

units

string

Optional

Units for localized distances in the response: METRIC or IMPERIAL. Defaults from the origin's locale. distanceMeters is always in meters. One of: `METRIC`, `IMPERIAL`.

googlemaps_routes_compute_matrix

Routes compute matrix

Compute travel time and distance for every pair of origins and destinations, such as from three warehouses to ten customers. Returns one element per origin-destination pair with originIndex, destinationIndex, status, condition, distanceMeters and duration. Use this to compare many trips at once. Use routes_compute for the path and turn-by-turn steps of a single trip.

Parameters

Name

Type

Required

Description

destinations

array

Required

End points, in the same formats as origins.

origins

array

Required

Start points. Each point can be a street address or place name ("1600 Amphitheatre Pkwy, Mountain View, CA"), a "latitude,longitude" pair ("37.4220,-122.0841"), or a Google place ID prefixed with place_id: ("place_id:ChIJj61dQgK6j4AR4GeTYWZsKWw"). Origins times destinations must be at most 625 (100 with TRAFFIC_AWARE_OPTIMAL or TRANSIT), and at most 50 points in total may be addresses or place IDs.

arrival_time

string

Optional

Desired arrival time as an RFC 3339 UTC timestamp, TRANSIT only. Can't be combined with departure_time.

avoid_ferries

boolean

Optional

If true, avoid ferries where reasonable. DRIVE and TWO_WHEELER only.

avoid_highways

boolean

Optional

If true, avoid highways where reasonable. DRIVE and TWO_WHEELER only.

avoid_tolls

boolean

Optional

If true, avoid toll roads where reasonable. DRIVE and TWO_WHEELER only.

departure_time

string

Optional

Departure time as an RFC 3339 UTC timestamp, for example 2026-11-02T15:00:00Z. Must be now or in the future (past times work only for TRANSIT). Defaults to now.

field_mask

string

Optional

Comma-separated list of response fields to return, sent as the X-Goog-FieldMask header. Google requires a field mask for this method and bills by the most expensive field requested. Always include status, otherwise failed elements look like successes. Example: originIndex,destinationIndex,status,condition,distanceMeters,duration. Use "*" only for testing. Default: `originIndex,destinationIndex,status,condition,distanceMeters,duration,localizedValues`.

language_code

string

Optional

Preferred language for instructions and localized values in the response, as a BCP-47 code such as en, fr or ja.

region_code

string

Optional

Two-letter CLDR/ccTLD region code that sets regional formatting and preferences, such as us, gb or in.

routing_preference

string

Optional

travel_mode

string

Optional

How to travel: DRIVE (default), BICYCLE, WALK, TWO_WHEELER or TRANSIT. One of: `DRIVE`, `BICYCLE`, `WALK`, `TWO_WHEELER`, `TRANSIT`.

units

string

Optional

Units for localized distances in the response: METRIC or IMPERIAL. Defaults from the origin's locale. distanceMeters is always in meters. One of: `METRIC`, `IMPERIAL`.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Google Maps tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlemaps"], toolNames: [
    "googlemaps_geocode_address",
    "googlemaps_places_search_nearby",
    "googlemaps_routes_compute"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Find coffee shops within 500 meters of 333 Post Street and get walking directions to the closest one" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlemaps"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Find coffee shops within 500 meters of 333 Post Street and get walking directions to the closest one" }],
  tools,
});

// Execute the tool call with the user's vaulted Google Maps API key
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlemaps"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Find coffee shops within 500 meters of 333 Post Street and get walking directions to the closest one" }],
  tools,
});

// Tool call runs with the user's vaulted Google Maps API key
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlemaps"] }, pageSize: 100,
});

const agent = new Agent({
  name: "location_agent",
  model: "gemini-2.5-pro",
  instruction: "Google Maps tools scoped to this user",
  tools,
});

await agent.run("Find coffee shops within 500 meters of 333 Post Street and get walking directions to the closest one");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Google Maps tool. Click to copy, paste into your agent, done.

Places

Copy the prompt

Copied

Find Italian restaurants near the Ferry Building with a rating above 4.5.

Copy the prompt

Copied

Get the opening hours and phone number for this place ID.

Copy the prompt

Copied

Suggest places as I type blue bottle mis.

Addresses

Copy the prompt

Copied

Validate this shipping address: 1600 Amphitheatre Pkwy, Mountain Vew CA.

Copy the prompt

Copied

Get the latitude and longitude for 221B Baker Street, London.

Copy the prompt

Copied

What address is at 40.7484, -73.9857?

Routes

Copy the prompt

Copied

How long is the drive from SFO to Palo Alto right now with traffic?

Copy the prompt

Copied

Compute travel times from our 3 warehouses to these 10 customer addresses.

Copy the prompt

Copied

Snap this GPS trace from the delivery van to the roads it drove.

SEE HOW AUTH WORKS

Each user connects their own Google Maps API key once, and Scalekit sends it with every call. Keys stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

Google Maps

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Google Maps

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Google Maps

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Google Maps

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other search and productivity connectors.

Support and Ops Teams

Meeting prep

Pulls agenda, participant context, and open action items before every meeting.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Google Maps API key looks fine in a demo. In production every place search and route request looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Google Maps today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Google Maps as the user or through a shared key?

As the user. Each user connects their own Google Maps API key once, and Scalekit sends it with every call. Place searches and route requests are attributed to that user in your audit trail, not a shared service account.

Where is the Google Maps API key stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new API key. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Google Maps?

Yes. Every Google Maps tool is read-only, so the agent cannot change anything. You can still filter by tool name in listScopedTools, for example to expose the places and geocoding tools without the roads and route matrix tools. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Google Maps access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Does the agent need coordinates to search for places?

No. googlemaps_places_search_text takes a free-text query such as pizza in New York and returns up to 20 places per page. googlemaps_places_search_nearby searches a circle around a latitude and longitude, which the agent can get from googlemaps_geocode_address.