addressdetails

example

{
  "addresses": [
    {
      "type": "primary residence",
      "street": "Main Street",
      "number": "123",
      "unit": "Apt 5B",
      "floor": "3",
      "city": "Berlin",
      "state": "Berlin",
      "postalCode": "10115",
      "country": "DE",
      "geolocation": {
        "latitude": 52.5200,
        "longitude": 13.4050
      }
    },
    {
      "type": "secondary residence",
      "street": "Elm Street",
      "number": "456",
      "city": "Munich",
      "state": "Bavaria",
      "postalCode": "80331",
      "country": "DE"
    }
  ]
}

schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/doku.php?id=schemes:person:addressdetails",
  "title": "person:addressdetails",
  "description": "A schema for representing a person's addresses.",
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "description": "A list of the person's addresses, including type and geolocation information.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of address, e.g., primary residence, secondary residence, work.",
            "example": "primary residence"
          },
          "street": {
            "type": "string",
            "description": "The street name of the address.",
            "example": "Main Street"
          },
          "number": {
            "type": "string",
            "description": "The house or building number of the address.",
            "example": "123"
          },
          "unit": {
            "type": "string",
            "description": "Optional unit, apartment, or room number.",
            "example": "Apt 5B"
          },
          "floor": {
            "type": "string",
            "description": "Optional floor number.",
            "example": "3"
          },
          "city": {
            "type": "string",
            "description": "The name of the city or town.",
            "example": "Berlin"
          },
          "state": {
            "type": "string",
            "description": "The state, province, or region.",
            "example": "Berlin"
          },
          "postalCode": {
            "type": "string",
            "description": "The postal or ZIP code.",
            "example": "10115"
          },
          "country": {
            "type": "string",
            "description": "The country in ISO 3166-1 Alpha-2 format.",
            "example": "DE"
          },
          "geolocation": {
            "type": "object",
            "description": "Geolocation coordinates for areas without structured addresses.",
            "properties": {
              "latitude": {
                "type": "number",
                "description": "The latitude of the location.",
                "example": 52.5200
              },
              "longitude": {
                "type": "number",
                "description": "The longitude of the location.",
                "example": 13.4050
              }
            },
            "required": ["latitude", "longitude"]
          }
        },
        "required": ["type", "street", "number", "city", "country"]
      }
    }
  },
  "required": ["addresses"]
}