AddressSchema

AddressSchema is a generic data model designed to represent postal addresses within software systems. It provides a structured scheme to capture location information in a consistent way, enabling reliable validation, storage, and interchange across services, databases, and APIs. While implementations vary, AddressSchema typically covers fields for street or address lines, city, region or state, postal code, country, and optional components such as house number, unit or apartment, and district. A minimal, interoperable instance usually includes addressLine1 (or streetAddress), city, region, postalCode, and country.

Fields are defined with string types; required fields depend on jurisdiction and use case. Common constraints include trimming whitespace, preserving original formatting, and validating country against an ISO 3166-1 alpha-2 code. Postal code validation may be country-specific, or unspecified to allow flexibility for regions without formal codes. The schema often supports nullability for optional parts and may permit multiple address lines for longer street addresses.

Internationalization considerations are central: AddressSchema aims to accommodate different address formats and languages, while enabling normalization for search, deduplication, and geocoding. It is frequently used in ecommerce, shipping, billing, and user profiles, and can map to standards such as schema.org PostalAddress or JSON Schema definitions. Extensions may include locale, language, PO box, or geolocation coordinates.

Example (minimal): addressLine1: "123 Main St"; city: "Anytown"; region: "CA"; postalCode: "90210"; country: "US".