- Category: places & weather
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? Yes
- Tools: 23
- Triggers: 0
- Slug:
GOOGLE_MAPS - Version: 20261101_00
- Instant: Supported on the latest version. Support varies by tool.
Frequently Asked Questions
How do I set up custom Google OAuth credentials for Google Maps?
How do I set up custom Google OAuth credentials for Google Maps?
Why am I seeing "App is blocked" when connecting Google Maps?
Why am I seeing "App is blocked" when connecting Google Maps?
Why am I getting "Google Maps API has not been used in project" error?
Why am I getting "Google Maps API has not been used in project" error?
Why am I getting "Error 400: invalid_scope"?
Why am I getting "Error 400: invalid_scope"?
Why does the OAuth consent screen show "Composio" instead of my app?
Why does the OAuth consent screen show "Composio" instead of my app?
Why am I getting 401 errors on tool calls?
Why am I getting 401 errors on tool calls?
What is required for the Maps Embed API?
What is required for the Maps Embed API?
GOOGLE_MAPS_MAPS_EMBED_API is API-key based. Google’s Maps Embed API requires an API key on each request; OAuth2 is not the auth path for this tool.You must use an API-key connection to use this tool.Tools
Autocomplete Place Predictions
Autocomplete Place Predictions
GOOGLE_MAPS_AUTOCOMPLETEReturns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance.Instant: Supported on the latest version.Instant pricing: $0.00283 per requestInput Parameters
Output
Compute Route Matrix
Compute Route Matrix
GOOGLE_MAPS_COMPUTE_ROUTE_MATRIXCalculates 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. Map results using originIndex and destinationIndex, and check condition for route availability.Instant: Supported on the latest version.Instant pricing: $0.010 per origin-destination pair ($0.005–$0.015 by options); max 100 pairs.Input Parameters
Output
Distance Matrix (Legacy)
Distance Matrix (Legacy)
GOOGLE_MAPS_DISTANCE_MATRIX_APIDEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern ‘Compute Route Matrix’ action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times. Capped at 100 elements per request (elements = origins × destinations count); split large sets into batches.Input Parameters
Output
Geocode Address
Geocode Address
GOOGLE_MAPS_GEOCODE_ADDRESSGeocode a street address or address components to latitude and longitude, which may be approximate. API key authentication supports component-only queries; OAuth without an API key requires an address. DEPRECATED: Consider the newer Text Search action instead.Input Parameters
Output
Geocode Address With Query
Geocode Address With Query
GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERYTool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify formattedAddress, region, and addressComponents in the response before using returned coordinates.Instant: Supported on the latest version.Instant pricing: $0.005 per address geocoding requestInput Parameters
Output
Geocode Destinations
Geocode Destinations
GOOGLE_MAPS_GEOCODE_DESTINATIONSTool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates.Input Parameters
Output
Reverse Geocode Location
Reverse Geocode Location
GOOGLE_MAPS_GEOCODE_LOCATIONTool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result.Instant: Supported on the latest version.Instant pricing: $0.005 per reverse geocoding requestInput Parameters
Output
Geocode Place by ID
Geocode Place by ID
GOOGLE_MAPS_GEOCODE_PLACETool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID.Instant: Supported on the latest version.Instant pricing: $0.005 per place geocoding requestInput Parameters
Output
Geocoding API
Geocoding API
GOOGLE_MAPS_GEOCODING_APIGeocode an address into geographic coordinates, reverse geocode coordinates to find an address, or look up a place by its Place ID using Google’s Geocoding API v4beta. Choose one lookup mode per request; language and region options can guide results.Instant: Supported on the latest version.Instant pricing: $0.005 per supported geocoding requestInput Parameters
components without address may return ZERO_RESULTS for some queries.Output
Geolocate Device
Geolocate Device
GOOGLE_MAPS_GEOLOCATEEstimate a device’s geographic location from cell tower and WiFi observations. With a connected Google Maps account, IP fallback can be used; managed requests require device observations and disable IP fallback.Instant: Supported on the latest version.Instant pricing: $0.005 per device geolocation request; IP fallback unavailableInput Parameters
Output
Get 2D Map Tile
Get 2D Map Tile
GOOGLE_MAPS_GET2D_TILETool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint.Instant: Supported on the latest version.Instant pricing: $0.0006 per returned 2D map tileInput Parameters
x.Output
Get 3D Tiles Root
Get 3D Tiles Root
GOOGLE_MAPS_GET3D_TILES_ROOTTool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google’s photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls.Instant: Supported on the latest version.Instant pricing: $0.006 per 3D root requestInput Parameters
Output
Get Directions
Get Directions
GOOGLE_MAPS_GET_DIRECTIONFetches directions between an origin and destination, with optional intermediate waypoints, travel modes, and preferences for avoiding tolls, highways, or ferries. DEPRECATED: Use the Google Maps Routes API instead. The legacy Directions API is not available to new Cloud projects; existing projects can continue to use it.Input Parameters
Output
Get Place Details
Get Place Details
GOOGLE_MAPS_GET_PLACE_DETAILSRetrieves details for a specific place by place ID or resource name. The returned details depend on the requested field mask; by default, it requests the ID, display name, and formatted address.Instant: Supported on the latest version.Instant pricing: $0.017 per request; selected fields may increase the price to $0.020Input Parameters
Output
Get Route
Get Route
GOOGLE_MAPS_GET_ROUTECalculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response duration is a string with ‘s’ suffix (e.g., "4557s"); parse before displaying.Instant: Supported on the latest version.Instant pricing: $0.010 per request; routing options may change the price to $0.005 or $0.015Input Parameters
routes.distanceMeters in the response is always in meters regardless of this setting; units only affects human-readable distance formatting in other fields.Route object fields to include in the response (e.g., ‘routes.distanceMeters,routes.duration’). If not specified, a default fieldMask is used based on travelMode: for TRANSIT mode, transit-specific fields (transitDetails, steps, etc.) are included; for other modes, basic route fields (distanceMeters, duration, polyline) are included. Fields not listed are absent from the response; explicitly include all needed fields such as routes.legs.steps and routes.polyline.encodedPolyline.Output
Get Time Zone
Get Time Zone
GOOGLE_MAPS_GET_TIME_ZONERetrieves time zone information for a specific geographic location and timestamp. Use this action when you need to determine the time zone ID, UTC offset, daylight savings offset, or localized time zone name for any point on Earth. The API considers the provided timestamp to accurately determine whether daylight savings is in effect at that moment.Instant: Supported on the latest version.Instant pricing: $0.005 per time zone requestInput Parameters
Output
Lookup Aerial Video
Lookup Aerial Video
GOOGLE_MAPS_LOOKUP_AERIAL_VIDEOTool to look up an aerial view video by address or video ID. Returns video metadata including state and URIs for playback. Use when you need to retrieve a previously rendered aerial video or check the status of a video render request. A PROCESSING response includes metadata.videoId for a later lookup and no playback URIs. Only a lookup returning a ready video is billable.Instant: Supported on the latest version.Instant pricing: $0.016 per ready aerial-video lookup; processing status checks are freeInput Parameters
Output
Embed Google Map
Embed Google Map
GOOGLE_MAPS_MAPS_EMBED_APIGenerates a Google Maps Embed URL and HTML iframe code for place, view, directions, street view, or search mode using an API key, without making an API call. Supply URL-escaped parameter values; generated URLs contain the key and location query.Input Parameters
Output
Nearby search
Nearby search
GOOGLE_MAPS_NEARBY_SEARCHSearches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.Instant: Supported on the latest version.Instant pricing: $0.032 per request; selected fields may increase the price to $0.035Input Parameters
Output
Get Place Photo
Get Place Photo
GOOGLE_MAPS_PLACE_PHOTORetrieves high quality photographic content from the Google Maps Places database. Use when you need to download a place photo using a photo_reference obtained from Place Details, Nearby Search, or Text Search requests. Images are scaled proportionally to fit within specified dimensions.Instant: Supported on the latest version.Instant pricing: $0.007 per New API photo request; discovery calls priced separatelyInput Parameters
Output
Render Aerial Video
Render Aerial Video
GOOGLE_MAPS_RENDER_AERIAL_VIDEOStarts rendering an aerial view video for a US postal address. Returns a video ID that can be used with lookupVideo to retrieve the video once rendering completes. Rendering typically takes up to a few hours.Input Parameters
Output
Text Search
Text Search
GOOGLE_MAPS_TEXT_SEARCHSearches for places on Google Maps using a textual query (e.g., “restaurants in London”, “Eiffel Tower”). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places — filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff.Instant: Supported on the latest version.Instant pricing: $0.032 per request; selected fields may increase the price to $0.035Input Parameters
pageSize, but this action uses maxResultCount.Output
Create Tiles Session
Create Tiles Session
GOOGLE_MAPS_TILES_CREATE_SESSIONCreates a session token for 2D map tiles or Street View imagery, reusable for subsequent tile requests within its validity window. Managed requests support standard-resolution 2D map sessions only.Instant: Supported on the latest version.Instant pricing: $0 per map-tile session creation; tile requests priced separately