Skip to navigation
Other Integrations

Google Maps

View as Markdown

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:

RequirementPurpose
Address Validation API enabledThe integration calls Google’s Address Validation API to validate and standardize addresses, returning formatted addresses, geocoordinates, and validation flags.
Billing enabled on Google Cloud projectAddress 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.
    • Go 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, go to Settings > Enterprise integrations > App store > Google Maps.

  • Click Connect

  • Enter your Google Cloud API key click Test to test the connection.

  • Click 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:

ErrorCauseResolution
”api_key is null”The integration configuration is missing the API key.Go to your integration settings and add the required API key.
403 ForbiddenThe 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 resultsGoogle 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 exceededYou have reached your Google Maps API usage limits.Check your Google Cloud Console to review quota limits and billing status.