Address Format Component

v2.0.1

Component

Standardized schema component for structured address information including geographic coordinates, business hours, accessibility features, and verification status.

Address Types

Required Field

20+

Properties

Global

ISO Standards

Purpose & Benefits

The Address Format component provides a comprehensive, standardized structure for all types of address information. It goes beyond basic postal addresses to include business context, accessibility, and AI-optimized data.

Geographic Coordinates

Precise latitude/longitude with accuracy measurements for mapping and location services

Business Hours

Structured operating hours for each day of the week with special hours support

Accessibility Information

Comprehensive accessibility features and wheelchair access details

Multilingual Support

Address names and descriptions in multiple languages for international businesses

Verification Status

Address verification tracking with methods and timestamps

Time Zone Support

IANA time zone identifiers for accurate local time calculations

Address Types

Supported address types for different business contexts

physical

Physical location of the business or organization

mailing

Postal address for correspondence

billing

Address for billing and invoicing purposes

shipping

Address for shipping and delivery

registered

Legal registered address

branch

Branch or subsidiary location

other

Other specialized address types

Schema Structure

Complete address format component schema

address-format.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Standardized Address Format",
  "description": "Reusable schema component for structured address information",
  "type": "object",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "properties": {
    "addressType": {
      "type": "string",
      "description": "Type of address",
      "enum": ["physical", "mailing", "billing", "shipping", "registered", "branch", "other"]
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Name associated with this address"
    },
    "streetAddress": {
      "type": "string",
      "description": "Street number and name"
    },
    "streetAddressLine2": {
      "type": "string",
      "description": "Apartment, suite, unit, building, floor, etc."
    },
    "city": { "type": "string", "description": "City/town/village" },
    "region": { "type": "string", "description": "State/province/region" },
    "postalCode": { "type": "string", "description": "Postal/ZIP code" },
    "country": { "type": "string", "description": "Country name" },
    "countryCode": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code",
      "pattern": "^[A-Z]{2}$"
    },
    "geoCoordinates": {
      "type": "object",
      "properties": {
        "latitude": { "type": "number", "minimum": -90, "maximum": 90 },
        "longitude": { "type": "number", "minimum": -180, "maximum": 180 },
        "elevation": { "type": "number" },
        "accuracy": { "type": "number", "minimum": 0 }
      },
      "required": ["latitude", "longitude"]
    },
    "timeZone": {
      "type": "string",
      "description": "IANA time zone identifier"
    },
    "accessibility": {
      "type": "object",
      "properties": {
        "wheelchairAccessible": { "type": "boolean" },
        "accessibilityFeatures": { "type": "array", "items": { "type": "string" } }
      }
    },
    "businessHours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dayOfWeek": { "type": "string", "enum": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"] },
          "opens": { "type": "string", "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$" },
          "closes": { "type": "string", "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$" },
          "isClosed": { "type": "boolean", "default": false }
        },
        "required": ["dayOfWeek"]
      }
    }
  },
  "required": ["addressType"]
}

Usage Example

Real-world address format implementation for a restaurant

Complete address with all features

{
  "addressType": "physical",
  "name": "Bella Vista Restaurant Main Location",
  "streetAddress": "123 Main Street",
  "streetAddressLine2": "Suite 101",
  "city": "Downtown",
  "region": "CA",
  "postalCode": "90210",
  "country": "United States",
  "countryCode": "US",
  "geoCoordinates": {
    "latitude": 34.0522,
    "longitude": -118.2437,
    "accuracy": 10
  },
  "timeZone": "America/Los_Angeles",
  "accessibility": {
    "wheelchairAccessible": true,
    "accessibilityFeatures": ["ramp_access", "accessible_parking", "wide_doorways"]
  },
  "businessHours": [
    {
      "dayOfWeek": "Monday",
      "opens": "09:00",
      "closes": "22:00"
    },
    {
      "dayOfWeek": "Sunday",
      "isClosed": true
    }
  ],
  "isVerified": true,
  "verificationMethod": "manual"
}

Usage in Entity Schemas

How address format is implemented within modules - address data is included directly, not via $ref

Note: Address format provides the structure standard, but modules include address data directly rather than using $ref references.

Address format used directly in location module

{
  "modules": {
    "location": {
      "version": "2.0.1",
      "enabled": true,
      "address": {
        "streetAddress": "123 Main Street",
        "addressLocality": "Downtown",
        "addressRegion": "CA",
        "postalCode": "90210",
        "addressCountry": "US"
      }
    }
  }
}

Advanced Features

Geographic Precision

Support for latitude/longitude coordinates with accuracy measurements, elevation data, and Plus Codes.

Plus Code, what3words, elevation tracking

Business Hours Integration

Built-in support for operating hours, special holiday hours, and closure information.

Daily hours, special dates, timezone-aware

Accessibility Compliance

Comprehensive accessibility information for individuals with disabilities.

Wheelchair access, accessibility features, compliance notes

Schema URL

Direct access to the address format component schema

https://schemas.meta-aiml.org/v2.0.1/components/address-format.json

Referenced via $ref in entity schemas and modules for consistent address formatting

← All Components Location Module →Multilingual Format →