NAiOS IconNAiOS Logo
Volver al catálogo

Google Maps

google_maps

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

Acciones
7
Triggers
0
Autenticación
OAuth gestionado
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Calculates 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

  • keystring

    Your application's API key. This key identifies your application for purposes of quota management.

  • modestringenum

    Specifies the mode of transport to use.

    drivingwalkingbicyclingtransit
  • avoidstringenum

    Indicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.

    tollshighwaysferriesindoor
  • unitsstringenum

    Specifies the unit system to use when displaying results. The default is metric.

    metricimperial
  • regionstring

    The region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.

  • originsstringObligatorio

    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).

  • languagestring

    The language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport

  • arrival_timeinteger

    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.

  • destinationsstringObligatorio

    One or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.

  • transit_modestringenum

    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'.

    bussubwaytraintramrail
  • traffic_modelstringenum

    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'.

    best_guesspessimisticoptimistic
  • departure_timeinteger

    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_preferencestringenum

    Specifies preferences for transit routes. This parameter may only be specified for transit directions.

    less_walkingfewer_transfers

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Geocoding, Reverse Geocoding, and Place ID LookupGOOGLE_MAPS_GEOCODING_APIAcción

Deprecated: 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

  • keystringObligatorio

    Your application's API key. This key identifies your application for purposes of quota management.

  • boundsstring

    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.

  • latlngstring

    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.

  • regionstring

    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.

  • addressstring

    The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).

  • languagestring

    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_idstring

    The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.

  • componentsstring

    A components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing.

  • result_typestring

    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_typestring

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

    Use this parameter to specify additional features in the response. Can select multiple values.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get directionsGOOGLE_MAPS_GET_DIRECTIONAcción

Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.

Parámetros de entrada

  • modestring

    The mode of transportation for which to calculate directions. Supported values are 'driving' (default), 'walking', 'bicycling', and 'transit'.

  • avoidstring

    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'.

  • unitsstring

    The unit system for displaying distances. Supported values are 'metric' (kilometers and meters) and 'imperial' (miles and feet). Defaults to 'imperial'.

  • originstringObligatorio

    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').

  • languagestring

    The language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.

  • waypointsstring

    A comma-separated string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination.

  • destinationstringObligatorio

    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').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get RouteGOOGLE_MAPS_GET_ROUTEAcción

Calculates 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

  • unitsstringenum

    Unit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.

    METRICIMPERIAL
  • fieldMaskstring

    Comma-separated list of `Route` object fields to include in the response (e.g., 'routes.distanceMeters,routes.duration') for efficiency.

  • travelModestringenum

    Mode of transportation for the route.

    DRIVEBICYCLEWALKTWO_WHEELERTRANSIT
  • languageCodestring

    BCP-47 language code (e.g., 'en-US', 'es') for textual information like navigation instructions.

  • origin_addressstringObligatorio

    Starting point address or place name for the route calculation.

  • routingPreferencestringenum

    Specifies 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_OPTIMAL
  • destination_addressstringObligatorio

    Destination point address or place name for the route calculation.

  • computeAlternativeRoutesboolean

    Computes and returns alternative routes if true.

  • routeModifiers_avoidTollsboolean

    Attempts to avoid toll roads if true.

  • routeModifiers_avoidFerriesboolean

    Attempts to avoid ferries if true.

  • routeModifiers_avoidHighwaysboolean

    Attempts to avoid highways if true.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Embed Google MapGOOGLE_MAPS_MAPS_EMBED_APIAcción

Tool 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

  • modestringObligatorioenum

    The mode of the embedded map.

    placeviewdirectionsstreetviewsearch
  • view_paramsobject

    Parameters for 'view' mode.

  • place_paramsobject

    Parameters for 'place' mode.

  • search_paramsobject

    Parameters for 'search' mode.

  • directions_paramsobject

    Parameters for 'directions' mode.

  • streetview_paramsobject

    Parameters for 'streetview' mode.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Nearby searchGOOGLE_MAPS_NEARBY_SEARCHAcción

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.

Parámetros de entrada

  • radiusnumberObligatorio

    Radius of the circular search area in meters.

  • latitudenumberObligatorio

    Latitude coordinate of the search center in decimal degrees.

  • fieldMaskstring

    Comma-separated list of place fields for the response (e.g., 'places.displayName,places.formattedAddress'); use '*' for all fields.

  • longitudenumberObligatorio

    Longitude 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.

  • maxResultCountinteger

    Maximum number of search results to return (up to 20); the actual count may be lower.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Text SearchGOOGLE_MAPS_TEXT_SEARCHAcción

Searches for places on google maps using a textual query (e.g., "restaurants in london", "eiffel tower").

Parámetros de entrada

  • fieldMaskstring

    Comma-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.

  • textQuerystringObligatorio

    Text query for searching places. Matched against place name, address, and category.

  • maxResultCountinteger

    Maximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not