> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps

> Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.

![Google Maps logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/google_maps.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=16a3c65324a0d69a8510b428a084b242)

* **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

> [accordion] How do I set up custom Google OAuth credentials for Google Maps?
>
> For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I seeing "App is blocked" when connecting Google Maps?
>
> The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.
>
> Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I getting "Google Maps API has not been used in project" error?
>
> When using custom OAuth credentials, the Google Maps API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.

> [accordion] Why am I getting "Error 400: invalid\_scope"?
>
> The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](https://composio-preview.mintlify.site/docs/authentication/programmatic-auth-configs.md).

> [accordion] Why does the OAuth consent screen show "Composio" instead of my app?
>
> By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling authentication](https://composio-preview.mintlify.site/docs/authentication/white-labeling-authentication.md#using-your-own-oauth-apps).

> [accordion] Why am I getting 401 errors on tool calls?
>
> The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (\~50 per account) was exceeded. Re-authenticating the user typically resolves this.

> [accordion] 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

> [accordion] Autocomplete Place Predictions
>
> **Slug:** `GOOGLE_MAPS_AUTOCOMPLETE`
>
> Returns 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 request
>
> #### Input Parameters
>
> **input** `string` *required*
>
> Text string to search for place predictions. Can be full words, substrings, place names, addresses, or plus codes. Must be non-empty.
>
> **origin** `object`
>
> Latitude/longitude point for distance calculations.
>
> **regionCode** `string`
>
> Region code in ccTLD format for formatting responses (e.g., 'us', 'br').
>
> **inputOffset** `integer`
>
> Zero-based Unicode character offset of cursor position in the input string.
>
> **languageCode** `string`
>
> Preferred language for results using IETF BCP-47 language codes (e.g., 'en-US', 'es-ES').
>
> **locationBias** `object`
>
> Area to bias search results toward.
>
> **sessionToken** `string`
>
> User-generated string grouping calls into sessions for billing purposes.
>
> **includedRegionCodes** `array`
>
> Up to 15 two-character country codes (ISO 3166-1 Alpha-2) to restrict results. Query predictions unavailable when this is set.
>
> **locationRestriction** `object`
>
> Area to restrict search results within.
>
> **includedPrimaryTypes** `array`
>
> Restricts results to up to five specified primary types (e.g., 'restaurant', 'cafe').
>
> **includeQueryPredictions** `boolean`
>
> Includes query predictions in response for text searches (default: false).
>
> **includePureServiceAreaBusinesses** `boolean`
>
> Includes businesses without physical locations (default: false).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Compute Route Matrix
>
> **Slug:** `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. 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
>
> **units** `string ("METRIC" | "IMPERIAL")`
>
> Unit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances. Note: distanceMeters in responses is always in meters regardless of this setting; units affects only human-readable text output.
>
> **origins** `array` *required*
>
> List of origin locations. Each can be specified as an address or latitude/longitude coordinates.
>
> **fieldMask** `string`
>
> Comma-separated list of response fields to include (e.g., 'originIndex,destinationIndex,duration,distanceMeters,status'). Keep originIndex, destinationIndex and status in the mask; some connections reject requests without them. Use '\*' for all fields.
>
> **travelMode** `string ("DRIVE" | "BICYCLE" | "WALK" | "TWO_WHEELER" | "TRANSIT")`
>
> Mode of transportation for the route matrix calculation.
>
> **destinations** `array` *required*
>
> List of destination locations. Each can be specified as an address or latitude/longitude coordinates.
>
> **languageCode** `string`
>
> BCP-47 language code (e.g., 'en-US', 'es') for textual information.
>
> **routingPreference** `string ("ROUTING_PREFERENCE_UNSPECIFIED" | "TRAFFIC_UNAWARE" | "TRAFFIC_AWARE" | "TRAFFIC_AWARE_OPTIMAL")`
>
> Specifies factors to consider when calculating the route.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Distance Matrix (Legacy)
>
> **Slug:** `GOOGLE_MAPS_DISTANCE_MATRIX_API`
>
> DEPRECATED: 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
>
> **key** `string`
>
> Your application's API key. This key identifies your application for purposes of quota management.
>
> **mode** `string ("driving" | "walking" | "bicycling" | "transit")`
>
> Specifies the mode of transport to use.
>
> **avoid** `string ("tolls" | "highways" | "ferries" | "indoor")`
>
> Indicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.
>
> **units** `string ("metric" | "imperial")`
>
> Specifies the unit system to use when displaying results. The default is metric.
>
> **region** `string`
>
> The region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.
>
> **origins** `string` *required*
>
> The starting point for calculating travel distance and time. You can supply one or more locations separated by the pipe character (|), in the form of a place ID (prefixed with place\_id:), an address, latitude/longitude coordinates (e.g., '40.7128,-74.0060'), a plus code, or an encoded polyline (prefixed with enc: and a colon).
>
> **language** `string`
>
> The language in which to return results. See the list of supported languages: [https://developers.google.com/maps/faq#languagesupport](https://developers.google.com/maps/faq#languagesupport)
>
> **arrival\_time** `integer`
>
> Specifies the desired time of arrival for transit directions, in seconds since midnight, January 1, 1970 UTC. You can specify either departure\_time or arrival\_time, but not both.
>
> **destinations** `string` *required*
>
> One or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.
>
> **transit\_mode** `string ("bus" | "subway" | "train" | "tram" | "rail")`
>
> Specifies one or more preferred modes of transit. This parameter may only be specified for transit directions. Multiple values can be pipe-separated e.g. 'bus|train'.
>
> **traffic\_model** `string ("best_guess" | "pessimistic" | "optimistic")`
>
> Specifies the assumptions to use when calculating time in traffic. This parameter is only used if the request includes a departure\_time and mode is 'driving'.
>
> **departure\_time** `string`
>
> Specifies the desired time of departure. You can specify the time as an integer in seconds since midnight, January 1, 1970 UTC, or as the string 'now'. Required for duration\_in\_traffic.
>
> **transit\_routing\_preference** `string ("less_walking" | "fewer_transfers")`
>
> Specifies preferences for transit routes. This parameter may only be specified for transit directions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geocode Address
>
> **Slug:** `GOOGLE_MAPS_GEOCODE_ADDRESS`
>
> Geocode 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
>
> **key** `string`
>
> Your application's API key. This parameter is required when using API key authentication. If not provided, will attempt to use OAuth authentication (requires X-Goog-User-Project header with project ID).
>
> **bounds** `string`
>
> Bounding box of the viewport within which to bias geocode results more prominently. Format: southwest\_lat,southwest\_lng|northeast\_lat,northeast\_lng. This parameter will only influence, not fully restrict, results from the geocoder.
>
> **region** `string`
>
> Region code specified as a ccTLD (country code top-level domain) two-character value. This parameter will only influence, not fully restrict, results from the geocoder.
>
> **address** `string`
>
> The street address that you want to geocode, in the format used by the national postal service of the country concerned. Additional address elements such as business names and unit, suite or floor numbers should be avoided. Street address elements should be delimited by spaces (shown here as url-escaped to %20). If both address and components are provided, address takes precedence.
>
> **language** `string`
>
> Language in which to return results. If not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent.
>
> **components** `string`
>
> Component filters separated by a pipe (|). Each component filter consists of component:value pair and fully restricts results from the geocoder. Examples: components=country:US or components=postal\_code:94043|country:US. If both address and components are provided, address takes precedence.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geocode Address With Query
>
> **Slug:** `GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERY`
>
> Tool 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 request
>
> #### Input Parameters
>
> **region\_code** `string`
>
> Region code, specified as a ccTLD two-character value (e.g., 'US', 'FR'). This parameter affects results based on applicable law.
>
> **address\_query** `string` *required*
>
> The unstructured address to geocode. This should be a single string containing the full address (e.g., '1600 Amphitheatre Parkway Mountain View CA'). Include city, state/region, and country where possible — incomplete or ambiguous strings may return zero results or incorrect matches.
>
> **language\_code** `string`
>
> Language in which the results should be returned (e.g., 'en', 'es', 'fr').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geocode Destinations
>
> **Slug:** `GOOGLE_MAPS_GEOCODE_DESTINATIONS`
>
> Tool 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
>
> **place** `string`
>
> Resource name in format 'places/\{placeId}' to retrieve destination by Place ID
>
> **regionCode** `string`
>
> Two-character ccTLD region code for formatting/filtering (e.g., 'US', 'UK')
>
> **travelModes** `array`
>
> Filter navigation points by travel mode. Supported values: DRIVE, WALK
>
> **addressQuery** `object`
>
> Address query in unstructured or structured format
>
> **languageCode** `string`
>
> Preferred language code for results (e.g., 'en', 'es', 'fr')
>
> **locationQuery** `object`
>
> Location query using geographic coordinates
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reverse Geocode Location
>
> **Slug:** `GOOGLE_MAPS_GEOCODE_LOCATION`
>
> Tool 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 request
>
> #### Input Parameters
>
> **types** `array`
>
> Set of type tags to restrict results; results without specified types are removed
>
> **latitude** `number` *required*
>
> Latitude coordinate in degrees, range \[-90.0, +90.0]
>
> **longitude** `number` *required*
>
> Longitude coordinate in degrees, range \[-180.0, +180.0]
>
> **regionCode** `string`
>
> Region code specified as a ccTLD two-character value, affecting results based on applicable law
>
> **languageCode** `string`
>
> Language code in which the results should be returned (BCP-47 format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geocode Place by ID
>
> **Slug:** `GOOGLE_MAPS_GEOCODE_PLACE`
>
> Tool 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 request
>
> #### Input Parameters
>
> **place\_id** `string` *required*
>
> Place identifier to geocode. Must be in the format 'places/\{placeId}' or just the place ID (e.g., 'ChIJj61dQgK6j4AR4GeTYWZsKWw'). The unique identifier for a place in the Google Places database.
>
> **regionCode** `string`
>
> Region code specified as a ccTLD two-character value, affecting results based on applicable law and address formatting.
>
> **languageCode** `string`
>
> Language code in which the results should be returned (BCP-47 format). Defaults to 'en' if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geocoding API
>
> **Slug:** `GOOGLE_MAPS_GEOCODING_API`
>
> Geocode 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 request
>
> #### Input Parameters
>
> **key** `string`
>
> Your application's API key. If not provided, will be extracted from connection metadata.
>
> **bounds** `string`
>
> The bounding box of the viewport within which to bias geocode results more prominently (e.g., '34.172684,-118.604794|34.236144,-118.500938'). This parameter will only influence, not fully restrict, results.
>
> **latlng** `string`
>
> The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., '40.714224,-73.961452'). Provide for reverse geocoding.
>
> **region** `string`
>
> The region code, specified as a ccTLD ('top-level domain') two-character value. This parameter will only influence, not fully restrict, results from the geocoder.
>
> **address** `string`
>
> The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).
>
> **language** `string`
>
> The language in which to return results. If language is not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent.
>
> **place\_id** `string`
>
> The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.
>
> **components** `string`
>
> A components filter with elements separated by a pipe (|). E.g., 'postal\_code:94043|country:US'. Used for geocoding, can be restrictive or biasing. Supplying only `components` without `address` may return ZERO\_RESULTS for some queries.
>
> **result\_type** `string`
>
> A filter of one or more address types, separated by a pipe (|) (e.g., 'street\_address|locality'). Used for reverse geocoding and place ID geocoding.
>
> **location\_type** `string`
>
> A filter of one or more location types, separated by a pipe (|) (e.g., 'ROOFTOP|RANGE\_INTERPOLATED'). Used for reverse geocoding and place ID geocoding.
>
> **extra\_computations** `array`
>
> Use this parameter to specify additional features in the response. Can select multiple values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Geolocate Device
>
> **Slug:** `GOOGLE_MAPS_GEOLOCATE`
>
> Estimate 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 unavailable
>
> #### Input Parameters
>
> **carrier** `string`
>
> Carrier name.
>
> **radioType** `string ("gsm" | "cdma" | "wcdma" | "lte" | "nr")`
>
> Radio type. Defaults to 'gsm'.
>
> **cellTowers** `array`
>
> Array of cell tower objects.
>
> **considerIp** `boolean`
>
> Whether to fall back to IP geolocation if WiFi and cell tower signals are missing. Defaults to true when your own Google Maps account is connected; otherwise IP fallback is always disabled and device observations are required.
>
> **wifiAccessPoints** `array`
>
> Array of WiFi access point objects (minimum 2 required for success).
>
> **homeMobileCountryCode** `integer`
>
> Mobile country code for device's home network. Range: 0-999.
>
> **homeMobileNetworkCode** `integer`
>
> MNC for GSM/WCDMA/LTE/NR (0-999); SID for CDMA (0-32767).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get 2D Map Tile
>
> **Slug:** `GOOGLE_MAPS_GET2D_TILE`
>
> Tool 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 tile
>
> #### Input Parameters
>
> **x** `integer` *required*
>
> Tile column coordinate. Valid range: \[0, (2^zoom)-1].
>
> **y** `integer` *required*
>
> Tile row coordinate. Valid range: \[0, (2^(zoom-1))-1]. Valid range: \[0, (2^zoom)-1], same as `x`.
>
> **z** `integer` *required*
>
> Zoom level ranging from 0 (entire world) to 22 (highly detailed).
>
> **key** `string`
>
> Google API key for authentication. If not provided, will be extracted from connection metadata. Required if not using Bearer token authentication.
>
> **session** `string` *required*
>
> Session token UUID obtained from /v1/createSession endpoint. Valid for approximately two weeks. Required for all 2D tile requests. Reuse across multiple tile requests; each createSession call consumes quota.
>
> **orientation** `integer`
>
> Rotation parameter in degrees counter-clockwise. Valid values: 0, 90, 180, or 270.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get 3D Tiles Root
>
> **Slug:** `GOOGLE_MAPS_GET3D_TILES_ROOT`
>
> Tool 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 request
>
> #### Input Parameters
>
> **key** `string`
>
> Your Google Maps API key with Map Tiles API enabled. If not provided, will be extracted from connection metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Directions
>
> **Slug:** `GOOGLE_MAPS_GET_DIRECTION`
>
> Fetches 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
>
> **mode** `string ("driving" | "walking" | "bicycling" | "transit")`
>
> The mode of transportation for which to calculate directions.
>
> **avoid** `string`
>
> Specifies features to avoid in the generated route. Multiple values can be combined using a pipe delimiter (e.g., 'tolls|highways'). Valid options include 'tolls', 'highways', and 'ferries'.
>
> **units** `string ("metric" | "imperial")`
>
> The unit system for displaying distances. Defaults to 'imperial'.
>
> **origin** `string` *required*
>
> The starting point for the directions. This can be a textual address (e.g., '123 Main St, Los Angeles, CA'), a place name (e.g., 'Disneyland'), or latitude/longitude coordinates (e.g., '34.0522,-118.2437').
>
> **language** `string`
>
> The language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.
>
> **waypoints** `string`
>
> A pipe-separated (|) string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination. For example: 'Anaheim, CA|Long Beach, CA' or 'Hollywood Bowl|Getty Center'.
>
> **destination** `string` *required*
>
> The ending point for the directions. This can be a textual address (e.g., '456 Park Ave, New York, NY'), a place name (e.g., 'Universal Studios Hollywood'), or latitude/longitude coordinates (e.g., '40.7128,-74.0060').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Place Details
>
> **Slug:** `GOOGLE_MAPS_GET_PLACE_DETAILS`
>
> Retrieves 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.020
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Google Place ID ONLY - an alphanumeric code (NOT a business name, address, or search query). Accepts 'places/\{place\_id}' or just the place\_id. Place IDs typically start with 'ChIJ' followed by alphanumeric characters. To find a place ID from a business name, first use TEXT\_SEARCH or NEARBY\_SEARCH.
>
> **fieldMask** `string`
>
> Comma-separated list of place fields to return (no spaces allowed). Use '\*' for all fields (not recommended for performance/cost). Common fields: id, displayName, formattedAddress, location, types, rating, photos, reviews, regularOpeningHours, nationalPhoneNumber, internationalPhoneNumber, websiteUri, googleMapsUri. Note: 'emailAddress' and 'phoneNumber' are NOT valid fields - use 'nationalPhoneNumber' or 'internationalPhoneNumber' instead.
>
> **regionCode** `string`
>
> Unicode country/region code (CLDR format) for region-specific display names. Examples: 'US', 'GB', 'FR', 'JP'. This affects how place names and addresses are formatted.
>
> **languageCode** `string`
>
> Preferred language code for place details (BCP-47 format). Examples: 'en' (English), 'es' (Spanish), 'fr' (French), 'ja' (Japanese). If not specified, defaults to the language of the request location.
>
> **sessionToken** `string`
>
> URL-safe base64 string (max 36 characters) for Autocomplete session billing. Used to group this request with previous Autocomplete requests for billing purposes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Route
>
> **Slug:** `GOOGLE_MAPS_GET_ROUTE`
>
> Calculates 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.015
>
> #### Input Parameters
>
> **units** `string ("METRIC" | "IMPERIAL")`
>
> Unit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances. Note: `routes.distanceMeters` in the response is always in meters regardless of this setting; `units` only affects human-readable distance formatting in other fields.
>
> **field\_mask** `string`
>
> Comma-separated list of `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`.
>
> **avoid\_tolls** `boolean`
>
> Attempts to avoid toll roads if true.
>
> **travel\_mode** `string ("DRIVE" | "BICYCLE" | "WALK" | "TWO_WHEELER" | "TRANSIT")`
>
> Mode of transportation for the route.
>
> **avoid\_ferries** `boolean`
>
> Attempts to avoid ferries if true.
>
> **language\_code** `string`
>
> BCP-47 language code (e.g., 'en-US', 'es') for textual information like navigation instructions.
>
> **avoid\_highways** `boolean`
>
> Attempts to avoid highways if true.
>
> **origin\_address** `string` *required*
>
> Starting point for the route calculation. Can be an address (e.g., '1600 Amphitheatre Parkway, Mountain View, CA') or coordinates as 'latitude,longitude' (e.g., '48.8566,2.3522').
>
> **routing\_preference** `string ("ROUTING_PREFERENCE_UNSPECIFIED" | "TRAFFIC_UNAWARE" | "TRAFFIC_AWARE" | "TRAFFIC_AWARE_OPTIMAL")`
>
> Specifies factors to consider when calculating the route.
>
> **destination\_address** `string` *required*
>
> Destination point for the route calculation. Can be an address (e.g., '85 10th Ave, New York, NY') or coordinates as 'latitude,longitude' (e.g., '40.7484,-73.9967').
>
> **compute\_alternative\_routes** `boolean`
>
> Computes and returns alternative routes if true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Zone
>
> **Slug:** `GOOGLE_MAPS_GET_TIME_ZONE`
>
> Retrieves 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 request
>
> #### Input Parameters
>
> **language** `string ("ar" | "bg" | "bn" | "ca" | "cs" | "da" | "de" | "el" | "en" | "en-AU" | "en-GB" | "es" | "eu" | "fa" | "fi" | "fil" | "fr" | "gl" | "gu" | "hi" | "hr" | "hu" | "id" | "it" | "iw" | "ja" | "kn" | "ko" | "lt" | "lv" | "ml" | "mr" | "nl" | "no" | "pl" | "pt" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "ta" | "te" | "th" | "tl" | "tr" | "uk" | "vi" | "zh-CN" | "zh-TW")`
>
> Supported language codes for Google Maps API.
>
> **location** `string` *required*
>
> A comma-separated latitude,longitude tuple representing the location to look up. For example: '39.6034810,-119.6822510'.
>
> **timestamp** `integer` *required*
>
> The desired time as seconds since midnight, January 1, 1970 UTC (Unix epoch time). The API uses this timestamp to determine whether Daylight Savings should be applied for the location's time zone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Aerial Video
>
> **Slug:** `GOOGLE_MAPS_LOOKUP_AERIAL_VIDEO`
>
> Tool 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 free
>
> #### Input Parameters
>
> **address** `string`
>
> A US postal address. Either videoId or address must be provided, but not both.
>
> **videoId** `string`
>
> An ID returned from videos.renderVideo. Either videoId or address must be provided, but not both.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Embed Google Map
>
> **Slug:** `GOOGLE_MAPS_MAPS_EMBED_API`
>
> Generates 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
>
> **mode** `string ("place" | "view" | "directions" | "streetview" | "search")` *required*
>
> The mode of the embedded map.
>
> **api\_key** `string`
>
> Google Maps API key. Required if not provided via connection metadata. The Maps Embed API only supports API key authentication, not OAuth.
>
> **view\_params** `object`
>
> Parameters for 'view' mode.
>
> **place\_params** `object`
>
> Parameters for 'place' mode.
>
> **search\_params** `object`
>
> Parameters for 'search' mode.
>
> **directions\_params** `object`
>
> Parameters for 'directions' mode.
>
> **streetview\_params** `object`
>
> Parameters for 'streetview' mode.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Nearby search
>
> **Slug:** `GOOGLE_MAPS_NEARBY_SEARCH`
>
> Searches 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.035
>
> #### Input Parameters
>
> **radius** `number` *required*
>
> Radius of the circular search area in meters.
>
> **latitude** `number` *required*
>
> Latitude coordinate of the search center in decimal degrees.
>
> **fieldMask** `string`
>
> Comma-separated list of place fields for the response. Fields are automatically prefixed with 'places.' if missing. Common fields: displayName, formattedAddress, id, types, rating, userRatingCount, location, businessStatus, regularOpeningHours, photos, reviews. Use '\*' for all fields (not recommended for production). Valid field names include: displayName, formattedAddress, shortFormattedAddress, id, types, primaryType, primaryTypeDisplayName, location, viewport, plusCode, rating, userRatingCount, reviews, regularOpeningHours, currentOpeningHours, photos, websiteUri, googleMapsUri, businessStatus, priceLevel, priceRange, addressComponents, utcOffsetMinutes, internationalPhoneNumber, nationalPhoneNumber, editorialSummary, accessibilityOptions, parkingOptions, paymentOptions, delivery, dineIn, takeout, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, allowsDogs, outdoorSeating, liveMusic, goodForChildren, goodForGroups.
>
> **longitude** `number` *required*
>
> Longitude coordinate of the search center in decimal degrees.
>
> **excludedTypes** `array`
>
> List of place types to exclude from Table A. Results matching any of these types are omitted. Up to 50 types allowed. Must be provided as a list, e.g., \['cafe'] for a single type or \['cafe', 'store'] for multiple types. Must use valid Table A types only.
>
> **includedTypes** `array`
>
> List of place types to include from Table A. Results will match at least one of these types. Up to 50 types allowed. Must be provided as a list, e.g., \['restaurant'] for a single type or \['atm', 'bank'] for multiple types. Common types: restaurant, cafe, bank, atm, hospital, pharmacy, school, park, gym, hotel, airport, gas\_station. IMPORTANT: 'food' is NOT a valid type (it's in Table B); use specific types like restaurant, cafe, bakery, fast\_food\_restaurant instead. Note: 'locality' is valid, but 'city', 'town', 'sublocality', 'landmark', and 'point\_of\_interest' are NOT valid for filtering.
>
> **maxResultCount** `integer`
>
> Maximum number of search results to return. Valid range: 1-20. The actual count may be lower based on available places.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Place Photo
>
> **Slug:** `GOOGLE_MAPS_PLACE_PHOTO`
>
> Retrieves 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 separately
>
> #### Input Parameters
>
> **maxwidth** `integer`
>
> Maximum desired width of the image in pixels (1-1600). Image will be scaled proportionally. You must specify either maxwidth, maxheight, or both.
>
> **maxheight** `integer`
>
> Maximum desired height of the image in pixels (1-1600). Image will be scaled proportionally. You must specify either maxwidth, maxheight, or both.
>
> **photo\_reference** `string` *required*
>
> A string identifier that uniquely identifies a photo. Can be either: (1) A full photo resource name in format 'places/\{place\_id}/photos/\{photo}' from the new Places API, or (2) Just the photo reference string from legacy API. Obtained from Place Details, Nearby Search, or Text Search requests. Note: Photo references cannot be cached and may expire over time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Aerial Video
>
> **Slug:** `GOOGLE_MAPS_RENDER_AERIAL_VIDEO`
>
> Starts 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
>
> **address** `string` *required*
>
> US postal address for which to render aerial video. Must be a valid US address with street, city, state, and postal code.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Text Search
>
> **Slug:** `GOOGLE_MAPS_TEXT_SEARCH`
>
> Searches 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.035
>
> #### Input Parameters
>
> **fieldMask** `string`
>
> Comma-separated list of place fields to return. When omitted, defaults to displayName and formattedAddress (requests through your own connected Google Maps account also include priceLevel). Requesting priceLevel increases the price. Common fields include: displayName, formattedAddress, types, rating, userRatingCount, priceLevel, websiteUri, nationalPhoneNumber, internationalPhoneNumber, regularOpeningHours, location, photos, googleMapsUri, businessStatus, id. The 'places.' prefix is optional and will be added automatically. Use '\*' for all fields (not recommended for performance/cost). Common aliases are supported: 'name'->displayName, 'address'->formattedAddress, 'url'/'website'->websiteUri, 'type'->types, 'phone'->nationalPhoneNumber. Invalid field names (e.g., places.phoneNumber instead of places.nationalPhoneNumber) cause errors. Many fields (rating, websiteUri, regularOpeningHours, nationalPhoneNumber) may be absent even when requested — handle nulls.
>
> **textQuery** `string` *required*
>
> Text query for searching places. Matched against place name, address, and category. Underspecified queries (missing city, region, or business type) yield empty or irrelevant results. Brand-name-only queries return multiple franchise branches — validate formattedAddress against the intended location.
>
> **maxResultCount** `integer`
>
> Maximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tiles Session
>
> **Slug:** `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. 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
>
> #### Input Parameters
>
> **scale** `string ("scaleFactor1x" | "scaleFactor2x" | "scaleFactor4x")`
>
> Label scaling factor for high-resolution displays. Valid values: 'scaleFactor1x' (standard), 'scaleFactor2x' (2x resolution), or 'scaleFactor4x' (4x resolution).
>
> **region** `string` *required*
>
> Two-letter CLDR region code representing the user's location (e.g., 'US', 'GB', 'FR'). This helps Google Maps provide region-specific content.
>
> **styles** `array`
>
> JSON style objects for customizing map appearance (roadmap only). Allows custom styling of map features like roads, buildings, and landmarks.
>
> **highDpi** `boolean`
>
> Enable high-resolution tiles for high DPI displays. Works only with 2x or 4x scale factors. Set to true for sharper images on high-resolution screens.
>
> **mapType** `string ("roadmap" | "satellite" | "terrain" | "streetview")` *required*
>
> Base map type. Valid values: 'roadmap' for standard road map, 'satellite' for satellite imagery, 'terrain' for terrain maps, or 'streetview' for street view imagery.
>
> **overlay** `boolean`
>
> Render map layers separately (true) or combined into a single image (false). Set to true if you want individual overlay layers.
>
> **language** `string` *required*
>
> IETF language tag specifying the display language for map labels and information (e.g., 'en-US', 'es-ES', 'fr-FR').
>
> **layerTypes** `array`
>
> Overlay options for the map. Valid values: 'layerRoadmap' (road overlay), 'layerStreetview' (street view overlay), 'layerTraffic' (traffic layer). Note: terrain mapType requires layerRoadmap.
>
> **imageFormat** `string ("jpeg" | "png")`
>
> Output format for tile images. Valid values: 'jpeg' or 'png'. If omitted, the format will be auto-selected by the API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
