---
id: google-i18n-address
version: "3.1.1"
license: BSD 3-Clause License Copyright (c) 2016, MIRUMEE SOFTWARE SP. Z O.O. SP.K. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# google-i18n-address — Address validation helpers for Google's i18n address database

License: permissive · Maintenance: active · Downloads: 160.3K/mo

## What it is and what it does

This package wraps Google's i18n address metadata repository to provide programmatic address validation, normalization, and formatting for addresses worldwide. It recognizes nine address fields (country code, region, city, postal code, street address, and others) and validates them against country-specific rules, either returning a canonical form suitable for storage or raising an exception with a list of validation errors.

Beyond validation, it offers address latinization (converting non-Latin scripts to Latin equivalents for display and search), address formatting according to postal regulations of the destination country, and access to validation rules for building country-specific address forms. The package ships with a snapshot of Google's metadata and depends only on requests; it is classified as production-stable and actively maintained.

Use it for:

- Validate and normalize user-submitted addresses in e-commerce checkout flows before storing or printing shipping labels.
- Build dynamic address forms that show only the fields required for a specific country and display appropriate field labels.
- Convert addresses with non-Latin scripts to Latin equivalents for display in systems that cannot render the original script.
- Validate postal codes and country regions against official rules to catch typos or invalid entries early.
- Format addresses for printing according to each country's post office standards to ensure deliverability.
- Pre-populate country-area choices and postal code patterns for form UI generation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Validates, normalizes, and formats postal addresses according to country-specific rules using Google's i18n address metadata, with support for latinization and form generation.

Yes. The package is production-stable, actively maintained, has low install friction, carries no known vulnerabilities, and solves a real problem—address validation and formatting across countries is tedious to implement correctly. Use it if you need to handle international addresses in any form. The BSD 3-Clause license is permissive and poses no compliance burden.

## Install

pip install google-i18n-address
uv add google-i18n-address
poetry add google-i18n-address

## Installing google-i18n-address

Before you install: Low friction: pure Python wheel with only requests as a runtime dependency. Active maintenance with recent commits and production-stable classification.

License in practice: BSD 3-Clause permissive license allows commercial and private use with minimal restrictions; retain copyright notice and disclaimer in distributions.

Quickstart:

pip install google-i18n-address

from google_i18n_address import normalize_address, InvalidAddressError

try:
    address = normalize_address({
        'country_code': 'US',
        'country_area': 'California',
        'city': 'Mountain View',
        'postal_code': '94043',
        'street_address': '1600 Amphitheatre Pkwy'
    })
    print(address)
except InvalidAddressError as e:
    print(e.errors)

Verify before relying:

- Whether requests dependency is used at runtime or only for optional data updates
- Frequency and coverage of i18n metadata updates relative to postal code rule changes

## Package facts

- License: BSD 3-Clause License Copyright (c) 2016, MIRUMEE SOFTWARE SP. Z O.O. SP.K. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record) (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 160.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

address validation by country, postal address normalization, international address formatting, address form generation, latinize foreign addresses, zip code validation, address field validation rules, internationalization, address-validation, postal-formatting

[View on SkillFed](https://skillfed.io/packages/google-i18n-address) · [View on PyPI](https://pypi.org/project/google-i18n-address/)