Google Maps (API Key)
Search for places, compute routes, validate addresses, and more with Google Maps Platform using an API key.
Authentication
This connector uses Token-based authentication.
info
Set up your connection in the Abstra Console before using it in your workflows.
How to use
Using the Smart Chat
Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".
Using the Web Editor
from abstra.connectors import run_connection_action
result = run_connection_action(
connection_name="your_connection_name",
action_name="your_action_name",
params={
"param1": "value1",
"param2": "value2"
})
Available Actions
This connector provides 33 actions:
| Action | Purpose | Parameters |
|---|---|---|
| places/places_search_nearby | Search for places near locations. | languageCode (string) regionCode (string) includedTypes (array) excludedTypes (array) includedPrimaryTypes (array) excludedPrimaryTypes (array) maxResultCount (integer) locationRestriction: { . circle (object) } (object) rankPreference (string) routingParameters: { . origin (object) . travelMode (string) . routeModifiers (object) . routingPreference (string) } (object) |
| places/places_search_text | Text query based place search. | textQuery (string) languageCode (string) regionCode (string) rankPreference (string) includedType (string) openNow (boolean) minRating (number) maxResultCount (integer) pageSize (integer) pageToken (string) priceLevels (array) strictTypeFiltering (boolean) locationBias: { . rectangle (object) . circle (object) } (object) locationRestriction: { . rectangle (object) } (object) evOptions: { . minimumChargingRateKw (number) . connectorTypes (array) } (object) routingParameters: { . origin (object) . travelMode (string) . routeModifiers (object) . routingPreference (string) } (object) searchAlongRouteParameters: { . polyline (object) } (object) includePureServiceAreaBusinesses (boolean) |
| places/places_get | Get the details of a place based on its resource name, which is a string in the places/place_id format. | name (string) required languageCode (string) regionCode (string) sessionToken (string) |
| places/places_autocomplete | Returns predictions for the given input. | input (string) locationBias: { . rectangle (object) . circle (object) } (object) locationRestriction: { . rectangle (object) . circle (object) } (object) includedPrimaryTypes (array) includedRegionCodes (array) languageCode (string) regionCode (string) origin: { . latitude (number) . longitude (number) } (object) inputOffset (integer) includeQueryPredictions (boolean) sessionToken (string) includePureServiceAreaBusinesses (boolean) |
| places/photos_get_media | Get a photo media with a photo reference string. | name (string) required maxWidthPx (integer) maxHeightPx (integer) skipHttpRedirect (boolean) |
| address_validation/v1_validate_address | Validates an address. | address: { . revision (integer) . regionCode (string) . languageCode (string) . postalCode (string) . sortingCode (string) . administrativeArea (string) . locality (string) . sublocality (string) . addressLines (array) . recipients (array) . organization (string) } (object) previousResponseId (string) enableUspsCass (boolean) languageOptions: { . returnEnglishLatinAddress (boolean) } (object) sessionToken (string) |
| address_validation/v1_provide_validation_feedback | Feedback about the outcome of the sequence of validation attempts. This should be the last call made after a sequence of validation calls for the same address, and should be called once the transaction is concluded. This should only be sent once for the sequence of ValidateAddress requests needed to validate an address fully. | conclusion (string) responseId (string) |
| routes/v2_compute_routes | Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints. NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using URL parameter $fields or fields, or by using an HTTP/gRPC header X-Goog-FieldMask see the available URL parameters and headershttps://cloud.google.com/apis/docs/system-parameters. The value is a comma separated list of field paths. See detailed documentat | origin: { . location (object) . placeId (string) . address (string) . via (boolean) . vehicleStopover (boolean) . sideOfRoad (boolean) } (object) destination: { . location (object) . placeId (string) . address (string) . via (boolean) . vehicleStopover (boolean) . sideOfRoad (boolean) } (object) intermediates (array) travelMode (string) routingPreference (string) polylineQuality (string) polylineEncoding (string) departureTime (string) arrivalTime (string) computeAlternativeRoutes (boolean) routeModifiers: { . avoidTolls (boolean) . avoidHighways (boolean) . avoidFerries (boolean) . avoidIndoor (boolean) . vehicleInfo (object) . tollPasses (array) } (object) languageCode (string) regionCode (string) units (string) optimizeWaypointOrder (boolean) requestedReferenceRoutes (array) extraComputations (array) trafficModel (string) transitPreferences: { . allowedTravelModes (array) . routingPreference (string) } (object) |
| routes/v2_compute_route_matrix | Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination. NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using the URL parameter $fields or fields, or by using the HTTP/gRPC header X-Goog-FieldMask see the available URL parameters and headershttps://cloud.google.com/apis/docs/system-parameters. The value is a comma separated list of field | origins (array) destinations (array) travelMode (string) routingPreference (string) departureTime (string) arrivalTime (string) languageCode (string) regionCode (string) units (string) extraComputations (array) trafficModel (string) transitPreferences: { . allowedTravelModes (array) . routingPreference (string) } (object) |
| airquality/current_conditions_lookup | The Current Conditions endpoint provides hourly air quality information in more than 100 countries, up to a 500 x 500 meters resolution. Includes over 70 local indexes and global air quality index and categories. | location: { . latitude (number) . longitude (number) } (object) universalAqi (boolean) extraComputations (array) languageCode (string) uaqiColorPalette (string) customLocalAqis (array) |
| airquality/history_lookup | Returns air quality history for a specific location for a given time range. | pageSize (integer) pageToken (string) location: { . latitude (number) . longitude (number) } (object) dateTime (string) hours (integer) period: { . startTime (string) . endTime (string) } (object) universalAqi (boolean) extraComputations (array) languageCode (string) uaqiColorPalette (string) customLocalAqis (array) |
| airquality/forecast_lookup | Returns air quality forecast for a specific location for a given time range. | location: { . latitude (number) . longitude (number) } (object) dateTime (string) period: { . startTime (string) . endTime (string) } (object) universalAqi (boolean) extraComputations (array) languageCode (string) uaqiColorPalette (string) customLocalAqis (array) pageSize (integer) pageToken (string) |
| airquality/heatmap_tiles_lookup_heatmap_tile | Returns a bytes array containing the data of the tile PNG image. | mapType (string) required zoom (integer) required x (integer) required y (integer) required |
| areainsights/v1_compute_insights | This method lets you retrieve insights about areas using a variety of filter such as: area, place type, operating status, price level and ratings. Currently 'count' and 'places' insights are supported. With 'count' insights you can answer questions such as 'How many restaurant are located in California that are operational, are inexpensive and have an average rating of at least 4 stars' see insight enum for more details. With 'places' insights, you can determine which places match the requested | insights (array) filter: { . locationFilter (object) . typeFilter (object) . operatingStatus (array) . priceLevels (array) . ratingFilter (object) } (object) |
| pollen/forecast_lookup | Returns up to 5 days of daily pollen information in more than 65 countries, up to 1km resolution. | location.latitude (number) location.longitude (number) days (integer) pageSize (integer) pageToken (string) languageCode (string) plantsDescription (boolean) |
| pollen/heatmap_tiles_lookup_heatmap_tile | Returns a byte array containing the data of the tile PNG image. | mapType (string) required zoom (integer) required x (integer) required y (integer) required |
| solar/building_insights_find_closest | Locates the building whose centroid is closest to a query point. Returns an error with code NOT_FOUND if there are no buildings within approximately 50m of the query point. | location.latitude (number) location.longitude (number) requiredQuality (string) exactQualityRequired (boolean) experiments (string) |
| solar/data_layers_get | Gets solar information for a region surrounding a location. Returns an error with code NOT_FOUND if the location is outside the coverage area. | location.latitude (number) location.longitude (number) radiusMeters (number) view (string) requiredQuality (string) pixelSizeMeters (number) exactQualityRequired (boolean) experiments (string) |
| solar/geo_tiff_get | Returns an image by its ID. | id (string) |
| streetview/photo_start_upload | Creates an upload session to start uploading photo bytes. The method uses the upload URL of the returned UploadRef to upload the bytes for the Photo. In addition to the photo requirements shown in https://support.google.com/maps/answer/7012050?ref_topic=6275604, the photo must meet the following requirements: Photo Sphere XMP metadata must be included in the photo metadata. See https://developers.google.com/streetview/spherical-metadata for the required fields. The pixel size of the photo must | No parameters |
| streetview/photo_create | After the client finishes uploading the photo with the returned UploadRef, CreatePhoto publishes the uploaded Photo to Street View on Google Maps. Currently, the only way to set heading, pitch, and roll in CreatePhoto is through the Photo Sphere XMP metadatahttps://developers.google.com/streetview/spherical-metadata in the photo bytes. CreatePhoto ignores the pose.heading, pose.pitch, pose.roll, pose.altitude, and pose.level fields in Pose. This method returns the following error codes: google. | photoId: { . id (string) } (object) uploadReference: { . uploadUrl (string) } (object) downloadUrl (string) thumbnailUrl (string) shareLink (string) pose: { . latLngPair (object) . altitude (number) . heading (number) . pitch (number) . roll (number) . gpsRecordTimestampUnixEpoch (string) . level (object) . accuracyMeters (number) } (object) connections (array) captureTime (string) uploadTime (string) places (array) viewCount (string) transferStatus (string) mapsPublishStatus (string) |
| streetview/photo_get | Gets the metadata of the specified Photo. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested Photo. google.rpc.Code.NOT_FOUND if the requested Photo does not exist. google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed. | photoId (string) required view (string) languageCode (string) |
| streetview/photo_update | Updates the metadata of a Photo, such as pose, place association, connections, etc. Changing the pixels of a photo is not supported. Only the fields specified in the updateMask field are used. If updateMask is not present, the update applies to all fields. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.INVALID_ARGUMENT if the request is malformed. google.rpc.Code.NOT_FOUND if the reque | id (string) required updateMask (string) photoId: { . id (string) } (object) uploadReference: { . uploadUrl (string) } (object) downloadUrl (string) thumbnailUrl (string) shareLink (string) pose: { . latLngPair (object) . altitude (number) . heading (number) . pitch (number) . roll (number) . gpsRecordTimestampUnixEpoch (string) . level (object) . accuracyMeters (number) } (object) connections (array) captureTime (string) uploadTime (string) places (array) viewCount (string) transferStatus (string) mapsPublishStatus (string) |
| streetview/photo_delete | Deletes a Photo and its metadata. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.NOT_FOUND if the photo ID does not exist. | photoId (string) required |
| streetview/photos_batch_get | Gets the metadata of the specified Photo batch. Note that if BatchGetPhotos fails, either critical fields are missing or there is an authentication error. Even if BatchGetPhotos succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status in BatchGetPhotosResponse.results. See GetPhoto for specific failures that can occur per photo. | photoIds (string) view (string) languageCode (string) |
| streetview/photos_list | Lists all the Photos that belong to the user. Note: Recently created photos that are still being indexed are not returned in the response. | view (string) pageSize (integer) pageToken (string) filter (string) languageCode (string) |
| streetview/photos_batch_update | Updates the metadata of Photos, such as pose, place association, connections, etc. Changing the pixels of photos is not supported. Note that if BatchUpdatePhotos fails, either critical fields are missing or there is an authentication error. Even if BatchUpdatePhotos succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status in BatchUpdatePhotosResponse.results. See UpdatePhoto for specific failures that can occur per photo. Only the fiel | updatePhotoRequests (array) |
| streetview/photos_batch_delete | Deletes a list of Photos and their metadata. Note that if BatchDeletePhotos fails, either critical fields are missing or there is an authentication error. Even if BatchDeletePhotos succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status in BatchDeletePhotosResponse.results. See DeletePhoto for specific failures that can occur per photo. | photoIds (array) |
| streetview/photo_sequence_start_upload | Creates an upload session to start uploading photo sequence data. The upload URL of the returned UploadRef is used to upload the data for the photoSequence. After the upload is complete, the UploadRef is used with CreatePhotoSequence to create the PhotoSequence object entry. | No parameters |
| streetview/photo_sequence_create | After the client finishes uploading the PhotoSequence with the returned UploadRef, CreatePhotoSequence extracts a sequence of 360 photos from a video or Extensible Device Metadata XDM, http://www.xdm.org/ to be published to Street View on Google Maps. CreatePhotoSequence returns an Operation, with the PhotoSequence Id set in the Operation.name field. This method returns the following error codes: google.rpc.Code.INVALID_ARGUMENT if the request is malformed. google.rpc.Code.NOT_FOUND if the upl | inputType (string) id (string) photos (array) uploadReference: { . uploadUrl (string) } (object) captureTimeOverride (string) uploadTime (string) rawGpsTimeline (array) gpsSource (string) imu: { . accelMpsps (array) . gyroRps (array) . magUt (array) } (object) processingState (string) failureReason (string) failureDetails: { . insufficientGpsDetails (object) . gpsDataGapDetails (object) . imuDataGapDetails (object) . notOutdoorsDetails (object) . noOverlapGpsDetails (object) } (object) distanceMeters (number) sequenceBounds: { . southwest (object) . northeast (object) } (object) viewCount (string) filename (string) |
| streetview/photo_sequence_get | Gets the metadata of the specified PhotoSequence via the Operation interface. This method returns the following three types of responses: Operation.done = false, if the processing of PhotoSequence is not finished yet. Operation.done = true and Operation.error is populated, if there was an error in processing. Operation.done = true and Operation.response is poulated, which contains a PhotoSequence message. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the | sequenceId (string) required view (string) filter (string) |
| streetview/photo_sequence_delete | Deletes a PhotoSequence and its metadata. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo sequence. google.rpc.Code.NOT_FOUND if the photo sequence ID does not exist. google.rpc.Code.FAILED_PRECONDITION if the photo sequence ID is not yet finished processing. | sequenceId (string) required |
| streetview/photo_sequences_list | Lists all the PhotoSequences that belong to the user, in descending CreatePhotoSequence timestamp order. | pageSize (integer) pageToken (string) filter (string) |