Das Schema person:nameandbirthdetails definiert:

Name:

• titles: Optionale Liste von Titeln (z. B. „Dr.“, „Prof.“, „Sir“).
• givenNames: Liste von Vornamen (mindestens ein Name erforderlich).
• familyNames: Liste von Nachnamen oder Familiennamen (mindestens ein Name erforderlich).
• suffixes: Optionale Namenszusätze (z. B. „Jr.“, „III“).
• preferredName: Der bevorzugte vollständige Name der Person.
• birthDate: Geburtsdatum im ISO-8601-Format (YYYY-MM-DD).

birthPlace:

• city: Stadt oder Ort des Geburtsortes.
• state: Optional, Bundesland oder Region.
• country: Länderkürzel nach ISO 3166-1 Alpha-2.

{
  "name": {
    "titles": ["Dr.", "Prof."],
    "givenNames": ["Max", "Karl"],
    "familyNames": ["Mustermann", "von Stottern"],
    "birthNames": ["Tester", "von Helsinki"],
    "suffixes": ["Jr."],
    "preferredName": "Dr. Max Mustermann"
  },
  "birthDate": "1990-01-01",
  "birthPlace": {
    "city": "Berlin",
    "state": "Berlin",
    "country": "DE"
  }
}

$person['nameandbirthdetails']['name']['titles'][0] = "Dr.";
$person['nameandbirthdetails']['name']['titles'][1] = "Prof.";

$person['nameandbirthdetails']['name']['givenNames'][0] = "Max";
$person['nameandbirthdetails']['name']['givenNames'][1] = "Karl";

$person['nameandbirthdetails']['name']['familyNames'][0] = "Mustermann";
$person['nameandbirthdetails']['name']['familyNames'][1] = "von Stottern";

$person['nameandbirthdetails']['name']['birthNames'][0] = "Tester";
$person['nameandbirthdetails']['name']['birthNames'][1] = "von Helsinki";

$person['nameandbirthdetails']['name']['suffixes'][0] = "Jr.";

$person['nameandbirthdetails']['name']['preferredName'] = "Dr. Max Mustermann";

$person['nameandbirthdetails']['birthDate'] = "1990-01-01";

$person['nameandbirthdetails']['birthPlace']['city'] = "Berlin";
$person['nameandbirthdetails']['birthPlace']['state'] = "Berlin";
$person['nameandbirthdetails']['birthPlace']['country'] = "DE";

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/doku.php?id=schemes:person:nameandbirthdetails",
  "title": "b2base:schemes:person:nameandbirthdetails",
  "description": "A globally valid schema for capturing name, birth date, and birth place.",
  "type": "object",
  "properties": {
    "name": {
      "type": "object",
      "description": "Information about the person's name.",
      "properties": {
        "titles": {
          "type": "array",
          "description": "List of titles with position in the name.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The title (e.g., Dr., Prof.)."
              },
              "position": {
                "type": "integer",
                "description": "The position of the title in the name (0-based)."
              }
            },
            "required": ["value", "position"]
          }
        },
        "givenNames": {
          "type": "array",
          "description": "List of given names with position in the name.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The given name."
              },
              "position": {
                "type": "integer",
                "description": "The position of the given name in the name (0-based)."
              }
            },
            "required": ["value", "position"]
          }
        },
        "familyNames": {
          "type": "array",
          "description": "List of family names with position in the name.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The family name."
              },
              "position": {
                "type": "integer",
                "description": "The position of the family name in the name (0-based)."
              }
            },
            "required": ["value", "position"]
          }
        },
        "additions": {
          "type": "array",
          "description": "List of any additions (e.g., Jr., von, al-) with position in the name.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The addition."
              },
              "position": {
                "type": "integer",
                "description": "The position of the addition in the name (0-based)."
              }
            },
            "required": ["value", "position"]
          }
        },
        "preferredName": {
          "type": "string",
          "description": "The person's preferred full name."
        },
        "originalScript": {
          "type": "string",
          "description": "The full name in the original script (e.g., Japanese, Chinese, Arabic).",
          "example": "张伟"
        },
        "transliteratedName": {
          "type": "string",
          "description": "The full name in transliterated form (e.g., Latin alphabet).",
          "example": "Zhang Wei"
        }
      },
      "required": ["preferredName"]
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "description": "The person's birth date in the format YYYY-MM-DD."
    },
    "birthPlace": {
      "type": "object",
      "description": "The person's birth place.",
      "properties": {
        "city": {
          "type": "string",
          "description": "The name of the city or town."
        },
        "stateOrRegion": {
          "type": "string",
          "description": "Optional, the state or region."
        },
        "province": {
          "type": "string",
          "description": "Optional, an additional administrative level like province or district."
        },
        "country": {
          "type": "string",
          "description": "Country code according to ISO 3166-1 Alpha-2."
        }
      },
      "required": ["city", "country"]
    }
  },
  "required": ["name", "birthDate", "birthPlace"]
}