Google Maps
google_mapsIntegrate Google Maps to access location data, geocoding, directions, and mapping services in your application.
Acciones disponibles (7)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Distance MatrixGOOGLE_MAPS_DISTANCE_MATRIX_APIAcciónCalculates travel distance and time for a matrix of origins and destinations. supports different modes of transportation and options like departure/arrival times. use when needing to determine travel metrics between multiple points.
GOOGLE_MAPS_DISTANCE_MATRIX_APIAcciónCalculates travel distance and time for a matrix of origins and destinations. supports different modes of transportation and options like departure/arrival times. use when needing to determine travel metrics between multiple points.
Parámetros de entrada
keystringYour application's API key. This key identifies your application for purposes of quota management.
modestringenumSpecifies the mode of transport to use.
drivingwalkingbicyclingtransitavoidstringenumIndicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.
tollshighwaysferriesindoorunitsstringenumSpecifies the unit system to use when displaying results. The default is metric.
metricimperialregionstringThe region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.
originsstringObligatorioThe 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).
languagestringThe language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport
arrival_timeintegerSpecifies 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.
destinationsstringObligatorioOne or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.
transit_modestringenumSpecifies 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'.
bussubwaytraintramrailtraffic_modelstringenumSpecifies 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'.
best_guesspessimisticoptimisticdeparture_timeintegerSpecifies 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_preferencestringenumSpecifies preferences for transit routes. This parameter may only be specified for transit directions.
less_walkingfewer_transfers
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Geocoding, Reverse Geocoding, and Place ID LookupGOOGLE_MAPS_GEOCODING_APIAcciónDeprecated: tool to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a place id. use for finding coordinates for an address, finding an address for coordinates, or looking up an address by its place id.
GOOGLE_MAPS_GEOCODING_APIAcciónDeprecated: tool to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a place id. use for finding coordinates for an address, finding an address for coordinates, or looking up an address by its place id.
Parámetros de entrada
keystringObligatorioYour application's API key. This key identifies your application for purposes of quota management.
boundsstringThe 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.
latlngstringThe 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.
regionstringThe region code, specified as a ccTLD ('top-level domain') two-character value. This parameter will only influence, not fully restrict, results from the geocoder.
addressstringThe street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).
languagestringThe 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_idstringThe place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.
componentsstringA components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing.
result_typestringA 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_typestringA 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_computationsstring[]Use this parameter to specify additional features in the response. Can select multiple values.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get directionsGOOGLE_MAPS_GET_DIRECTIONAcciónFetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.
GOOGLE_MAPS_GET_DIRECTIONAcciónFetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.
Parámetros de entrada
modestringThe mode of transportation for which to calculate directions. Supported values are 'driving' (default), 'walking', 'bicycling', and 'transit'.
avoidstringSpecifies 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'.
unitsstringThe unit system for displaying distances. Supported values are 'metric' (kilometers and meters) and 'imperial' (miles and feet). Defaults to 'imperial'.
originstringObligatorioThe 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').
languagestringThe language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.
waypointsstringA comma-separated string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination.
destinationstringObligatorioThe 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').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get RouteGOOGLE_MAPS_GET_ROUTEAcciónCalculates one or more routes between two specified locations using various travel modes and preferences; addresses must be resolvable by google maps.
GOOGLE_MAPS_GET_ROUTEAcciónCalculates one or more routes between two specified locations using various travel modes and preferences; addresses must be resolvable by google maps.
Parámetros de entrada
unitsstringenumUnit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.
METRICIMPERIALfieldMaskstringComma-separated list of `Route` object fields to include in the response (e.g., 'routes.distanceMeters,routes.duration') for efficiency.
travelModestringenumMode of transportation for the route.
DRIVEBICYCLEWALKTWO_WHEELERTRANSITlanguageCodestringBCP-47 language code (e.g., 'en-US', 'es') for textual information like navigation instructions.
origin_addressstringObligatorioStarting point address or place name for the route calculation.
routingPreferencestringenumSpecifies routing preference: `TRAFFIC_UNAWARE` (fastest, ignores traffic), `TRAFFIC_AWARE` (considers traffic, optimized), `TRAFFIC_AWARE_OPTIMAL` (most accurate traffic-based routing), or `ROUTING_PREFERENCE_UNSPECIFIED` (behavior similar to `TRAFFIC_UNAWARE`).
ROUTING_PREFERENCE_UNSPECIFIEDTRAFFIC_UNAWARETRAFFIC_AWARETRAFFIC_AWARE_OPTIMALdestination_addressstringObligatorioDestination point address or place name for the route calculation.
computeAlternativeRoutesbooleanComputes and returns alternative routes if true.
routeModifiers_avoidTollsbooleanAttempts to avoid toll roads if true.
routeModifiers_avoidFerriesbooleanAttempts to avoid ferries if true.
routeModifiers_avoidHighwaysbooleanAttempts to avoid highways if true.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Embed Google MapGOOGLE_MAPS_MAPS_EMBED_APIAcciónTool to generate an embeddable google map url and html iframe code. use when you need to display a map (place, view, directions, street view, search) on a webpage without javascript.
GOOGLE_MAPS_MAPS_EMBED_APIAcciónTool to generate an embeddable google map url and html iframe code. use when you need to display a map (place, view, directions, street view, search) on a webpage without javascript.
Parámetros de entrada
modestringObligatorioenumThe mode of the embedded map.
placeviewdirectionsstreetviewsearchview_paramsobjectParameters for 'view' mode.
place_paramsobjectParameters for 'place' mode.
search_paramsobjectParameters for 'search' mode.
directions_paramsobjectParameters for 'directions' mode.
streetview_paramsobjectParameters for 'streetview' mode.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Nearby searchGOOGLE_MAPS_NEARBY_SEARCHAcciónSearches 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.
GOOGLE_MAPS_NEARBY_SEARCHAcciónSearches 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.
Parámetros de entrada
radiusnumberObligatorioRadius of the circular search area in meters.
latitudenumberObligatorioLatitude coordinate of the search center in decimal degrees.
fieldMaskstringComma-separated list of place fields for the response (e.g., 'places.displayName,places.formattedAddress'); use '*' for all fields.
longitudenumberObligatorioLongitude coordinate of the search center in decimal degrees.
excludedTypesstring[]Place types to exclude (e.g., 'cafe', 'store'); results matching any of these types are omitted. For supported types, see Google Maps Places API documentation.
includedTypesstring[]Place types to include (e.g., 'restaurant', 'park'); results will match at least one of these types. For supported types, see Google Maps Places API documentation.
maxResultCountintegerMaximum number of search results to return (up to 20); the actual count may be lower.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Text SearchGOOGLE_MAPS_TEXT_SEARCHAcciónSearches for places on google maps using a textual query (e.g., "restaurants in london", "eiffel tower").
GOOGLE_MAPS_TEXT_SEARCHAcciónSearches for places on google maps using a textual query (e.g., "restaurants in london", "eiffel tower").
Parámetros de entrada
fieldMaskstringComma-separated list of place fields to return. Use `*` for all fields (not recommended for performance/cost). See Google Maps Places API documentation for field names.
textQuerystringObligatorioText query for searching places. Matched against place name, address, and category.
maxResultCountintegerMaximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not