Google Maps

Google Maps: Overview and setup

Automate address validation and geocoding with the Google Maps integration.

You can validate addresses, perform geocoding, and enhance location services across your workflows with the Google Maps integration. This eliminates shipping errors, improves field service routing, and ensures employee and vendor addresses are always accurate and deliverable.

Usecases

By connecting Google Maps, your teams can:

Standardize addresses: Validate and format employee addresses in user profiles during the onboarding process.
Verify asset locations: Confirm addresses for asset management and shipping purposes.
Manage changes: Validate location data accurately within change requests.

Permissions

The Google Maps integration uses an API key to authenticate requests. Before connecting, you must configure your Google Cloud project with the following requirements:

Requirement	Purpose
Address Validation API enabled	The integration calls Google's Address Validation API to validate and standardize addresses, returning formatted addresses, geocoordinates, and validation flags.
Billing enabled on Google Cloud project	Address Validation API is a paid API and requires billing to be enabled.
API key restriction (recommended)	Restrict your API key to only the Address Validation API for security to prevent misuse if the key is leaked.

Setup

Configure your Google Cloud project:
- Log in to your Google Cloud Console
- Enable the Address Validation API in your project. Also ensure Billing is enabled.
- Navigate to APIs & Services > Credentials
- Click Create Credentials > API Key
- Recommended: Click Restrict Key and limit it to the Address Validation API only
- Copy and securely store the API key
In your Atomicwork account, navigate to Settings > App Store > Google Maps.
Click on Connect
Enter your Google Cloud API key click on Test to test the connection.
Click on Connect to activate the integration.

Supported workflow actions

You can use the Validate Address action, which standardizes and verifies location data using Google's services.

Configure input fields

Address (Required) - Enter the full address, including street, city, state, and postal code.
Region code (Optional) - Provide a country code (for example, US, IN, GB) to improve validation accuracy and prevent Google from misinterpreting the country.

Response fields

When a workflow runs the Validate Address action, it returns detailed location data that you can use in subsequent workflow actions:

Formatted address: The standardized version of the input address.
Address complete: A true or false value indicating if the address has all required components.
Coordinates: The latitude and longitude of the location.
Validation flags: Indicators showing if components were unconfirmed, inferred, or replaced.
Granularity: Precision levels for the validation and geocode.
Place ID: The unique Google Place identifier.

Troubleshooting

If you encounter errors while using the integration, review the following solutions:

Error	Cause	Resolution
"api_key is null"	The integration configuration is missing the API key.	Navigate to your integration settings and add the required API key.
403 Forbidden	The provided API key does not have the Address Validation API enabled, or billing is not set up on your Google Cloud project.	Enable the Address Validation API in your Google Cloud project and ensure billing is enabled.
Invalid address results	Google may misinterpret the intended country without a region code.	Provide a region code (e.g., `US`, `IN`, `GB`) in your input to improve validation accuracy.
Quota exceeded	You have reached your Google Maps API usage limits.	Check your Google Cloud Console to review quota limits and billing status.