Google Maps → Validate Address

Overview

This Xano action validates a physical address using the Google Maps Address Validation API. It checks the accuracy, format, and existence of an address, returning structured validation results to help ensure reliable address data in your application.

Inputs

Function Stack

1. Google Maps API Request

• API Request: Sends a POST request to https://addressvalidation.googleapis.com/v1:validateAddress with the provided address_lines, optional region_code, language_code, session_token, and google_api_key.

2. Precondition

• Ensures the API response status is 200 (success).

3. Response

• Returns the validation result from the Google Maps API response.

Example Usage

Request

{
  "region_code": "us",
  "address_lines": "1600 Amphitheatre Parkway, Mountain View, CA",
  "language_code": "en",
  "session_token": "123e4567-e89b-12d3-a456-426614174000"
}

Response

{
  "result": {
    "verdict": {
      "inputGranularity": "PREMISE",
      "validationGranularity": "PREMISE",
      "geocodeGranularity": "PREMISE",
      "hasUnconfirmedComponents": false,
      "hasInferredComponents": false,
      "hasReplacedComponents": false
    },
    "address": {
      "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      // ...additional address fields
    },
    "geocode": {
      "location": {
        "latitude": 37.4224764,
        "longitude": -122.0842499
      },
      // ...additional geocode data
    }
    // ...other validation fields
  }
}

Notes

• The google_api_key must be valid and have Address Validation API access enabled.
• Use region_code to bias validation for addresses in a specific country.
• The response includes verdicts on address accuracy, granularity, and standardized formatting.

Troubleshooting

• REQUEST_DENIED: Check if your API key is correct and has Address Validation API access enabled.
• INVALID_ARGUMENT: Ensure all required address fields are provided and correctly formatted.
• ZERO_RESULTS: The address could not be validated; verify the address input.
• Other Errors: Refer to the Google Maps Address Validation API documentation for detailed error handling.

References

• Google Maps Address Validation API Documentation
• Google Maps API Error Messages