kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/Address.yaml
kempersc 66adec257e Add scripts for normalizing LinkML schemas and validating schema integrity 
- Implement `normalize_linkml_alt_descriptions.py` to convert structured alt_descriptions to the expected scalar form.
- Implement `normalize_linkml_structured_aliases.py` to flatten language-keyed structured_aliases into a standard list-of-objects format.
- Implement `validate_linkml_schema_integrity.py` to validate the integrity of LinkML schema bundles, checking for import resolution, YAML parsing, and reference existence.
2026-02-16 10:16:51 +01:00

294 lines
12 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/Address
name: address_class
title: Address Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
vcard: http://www.w3.org/2006/vcard/ns#
schema: http://schema.org/
locn: http://www.w3.org/ns/locn#
gleif_base: https://www.gleif.org/ontology/Base/
org: http://www.w3.org/ns/org#
dcterms: http://purl.org/dc/terms/
skos: http://www.w3.org/2004/02/skos/core#
imports:
- ./ReconstructionActivity
- ./AddressType
- ./HouseNumber
- linkml:types
- ../slots/in_country
- ../slots/has_label
- ../slots/has_section
- ../slots/has_type
- ../slots/derive_from
- ../slots/generated_by
- ../slots/located_in
- ../slots/has_latitude
- ../slots/has_locality
- ../slots/has_longitude
- ../slots/has_postal_code
- ../slots/has_geographic_subdivision
classes:
Address:
class_uri: vcard:Address
description: >-
Physical or postal address for heritage custodians and related entities.
Structured representation of location data following vCard (RFC6350), Schema.org, and EU Location Core Vocabulary standards. Supports both formatted string representation and component-based structured data.
alt_descriptions:
nl: "Fysiek of postadres voor erfgoedbeheerders en gerelateerde entiteiten.\nGestructureerde weergave van locatiegegevens volgens vCard (RFC6350), Schema.org en EU Location Core Vocabulary standaarden. Ondersteunt zowel geformatteerde tekenreeksweergave als componentgebaseerde gestructureerde gegevens."
de: "Physische oder Postadresse für Kulturgüterverwalter und verwandte Entitäten.\nStrukturierte Darstellung von Standortdaten nach vCard (RFC6350), Schema.org und EU Location Core Vocabulary Standards. Unterstützt sowohl formatierte Zeichenkettendarstellung als auch komponentenbasierte strukturierte Daten."
fr: "Adresse physique ou postale pour les dépositaires du patrimoine et entités connexes.\nReprésentation structurée des données de localisation selon les normes vCard (RFC6350), Schema.org et EU Location Core Vocabulary. Prend en charge à la fois la représentation sous forme de chaîne formatée et les données structurées basées sur les composants."
es: "Dirección física o postal para custodios del patrimonio y entidades relacionadas.\nRepresentación estructurada de datos de ubicación según los estándares vCard (RFC6350), Schema.org y EU Location Core Vocabulary. Admite tanto la representación de cadena formateada como datos estructurados basados en componentes."
ar: "عنوان فعلي أو بريدي لأمناء التراث والكيانات ذات الصلة.\nتمثيل منظم لبيانات الموقع وفقًا لمعايير vCard (RFC6350) وSchema.org ومفردات الموقع الأساسية للاتحاد الأوروبي. يدعم كل من تمثيل السلسلة المنسقة والبيانات المنظمة القائمة على المكونات."
id: "Alamat fisik atau pos untuk pengelola warisan dan entitas terkait.\nRepresentasi terstruktur dari data lokasi mengikuti standar vCard (RFC6350), Schema.org, dan EU Location Core Vocabulary. Mendukung representasi string yang diformat dan data terstruktur berbasis komponen."
zh: "遗产保管人及相关实体的物理或邮政地址。\n遵循 vCard (RFC6350)、Schema.org 和欧盟位置核心词汇标准的结构化位置数据表示。 支持格式化字符串表示和基于组件的结构化数据。"
examples:
- value: |
Address
├── has_section (e.g., "1", "221B", "25-27")
├── has_label (street name as Label, e.g., "Museumstraat")
├── postal_code (e.g., "1071 XX")
├── locality (e.g., "Amsterdam")
├── region (e.g., "Noord-Holland", "NL-NH")
├── country_name (e.g., "Netherlands", "NL")
└── has_label (formatted address as Label)
- value: |
# Simple address with formatted string
has_address:
- address_formatted: "Museumstraat 1, 1071 XX Amsterdam, Netherlands"
address_type: HEADQUARTERS
# Structured address with components
has_address:
- has_label:
- has_label: "Museumstraat"
language: "nl"
has_section:
- has_value: "1"
postal_code: "1071 XX"
locality: "Amsterdam"
region: "Noord-Holland"
country_name: "NL"
address_type: HEADQUARTERS
latitude: 52.3600
longitude: 4.8852
geonames_id: 2759794
- value:
has_section:
- has_value: "1"
has_label:
- has_label: Museumstraat
language: nl
- has_label: Museumstraat 1, 1071 XX Amsterdam, Netherlands
language: nl
has_postal_code: "1071 XX"
has_locality: Amsterdam
has_geographic_subdivision: Noord-Holland
in_country: NL
has_latitude: 52.36
has_longitude: 4.8852
has_type: HeadquartersAddress
description: Rijksmuseum headquarters address with structured components
- value:
has_label:
- has_label: 1600 Pennsylvania Avenue NW, Washington, DC 20500, USA
language: en
has_locality: Washington
has_geographic_subdivision: DC
in_country: US
description: Simple formatted address for US location
broad_mappings:
- vcard:Address
close_mappings:
- schema:PostalAddress
- locn:Address
- gleif_base:PhysicalAddress
related_mappings:
- org:siteAddress
- schema:address
structured_aliases:
- literal_form: adres
in_language: nl
- literal_form: postadres
in_language: nl
- literal_form: Adresse
in_language: de
- literal_form: Postanschrift
in_language: de
- literal_form: adresse
in_language: fr
- literal_form: adresse postale
in_language: fr
- literal_form: dirección
in_language: es
- literal_form: dirección postal
in_language: es
- literal_form: عنوان
in_language: ar
- literal_form: عنوان بريدي
in_language: ar
- literal_form: alamat
in_language: id
- literal_form: alamat pos
in_language: id
- literal_form: 地址
in_language: zh
- literal_form: 邮政地址
in_language: zh
keywords:
- address
- location
- street
- postal code
- city
- country
- headquarters
- visiting address
- storage address
slots:
- has_section
- has_postal_code
- has_locality
- located_in
- has_geographic_subdivision
- in_country
- has_label
- has_type
- has_latitude
- has_longitude
- derive_from
- generated_by
slot_usage:
has_section:
range: HouseNumber
required: false
examples:
- value:
has_value: "1"
- value:
has_value: "221B"
has_postal_code:
required: false
examples:
- value: "1071 XX"
has_locality:
required: false
examples:
- value: Amsterdam
located_in:
required: false
inlined: false
examples:
- value:
settlement_name: Amsterdam
country: NL
has_geographic_subdivision:
required: false
examples:
- value: Noord-Holland
- value: NL-NH
in_country:
required: false
examples:
- value: Netherlands
- value: NL
has_label:
multivalued: true
inlined: false
inlined_as_list: false
required: false
examples:
- value:
- has_label: Museumstraat
language: nl
- has_label: Museumstraat 1, 1071 XX Amsterdam, Netherlands
language: nl
has_type:
range: AddressType
required: false
multivalued: false
examples:
- value: HeadquartersAddress
has_latitude:
range: float
required: false
examples:
- value: 52.36
has_longitude:
range: float
required: false
examples:
- value: 4.8852
derived_from:
multivalued: true
required: false
generated_by:
range: ReconstructionActivity
required: false
notes:
- |
Preserved from prior description (commit d356aa77):
Preserved from prior description (commit d356aa77):
Physical or postal address for heritage custodians and related entities.
**ONTOLOGY ALIGNMENT**:
This class aligns with multiple established address ontologies:
| Ontology | Class | Notes |
|----------|-------|-------|
| **vCard** | `vcard:Address` | RFC6350 ADR property components |
| **Schema.org** | `schema:PostalAddress` | Web semantics |
| **LOCN** | `locn:Address` | EU Location Core Vocabulary |
| **GLEIF** | `gleif_base:PhysicalAddress` | Legal entity addresses |
**COMPONENT STRUCTURE**:
An address consists of hierarchical components:
NOTE: street_name slot migrated to has_label + Label (2026-01-17, Rule 53/56)
NOTE: street_address slot removed - was redundant string; use house_number + has_label (2026-01-17, Rule 53/56)
**ADDRESS TYPES FOR HERITAGE CUSTODIANS**:
| Type | Use Case |
|------|----------|
| `HEADQUARTERS` | Main organizational address |
| `LEGAL` | Registered legal/business address |
| `VISITING` | Public visitor entrance |
| `MAILING` | Correspondence/postal address |
| `STORAGE` | Depot, warehouse, off-site storage |
| `BRANCH` | Branch office location |
**USAGE EXAMPLES**:
**RELATIONSHIP TO OTHER CLASSES**:
- `AuxiliaryPlace`: Uses Address for structured address data
- `CustodianPlace`: May reference Address for place location
- `ContactPoint`: Uses Address for contact location
- `Settlement`/`Subregion`/`Country`: Hierarchical geographic entities
**PROVENANCE**:
Address data may be extracted from various sources (websites, Google Maps,
registries). Track provenance with:
- `was_derived_from`: Link to source observation
- `generated_by`: Link to extraction activity
annotations:
specificity_score: "0.25"
specificity_rationale: "Address is broadly applicable to all heritage custodian types and many other entities. Universal across domains."
custodian_types: "['*']"
custodian_types_rationale: "All heritage custodians have physical addresses - museums, archives, libraries, etc."
address_types: "HEADQUARTERS, LEGAL, VISITING, MAILING, STORAGE, BRANCH, READING_ROOM"
ontology_alignment_vcard: "RFC6350 ADR property components"
ontology_alignment_schema: "Web semantics"
ontology_alignment_locn: "EU Location Core Vocabulary"
ontology_alignment_gleif: "Legal entity addresses"
comments:
- vCard Address is the primary ontology class (RFC6350 standard)
- Use structured components when available, formatted string as fallback
- Multiple addresses supported via has_address slot (multivalued, Rule 39 compliant)
- Address types distinguish headquarters, legal, visiting, mailing, storage
- Coordinates (lat/lon) optional but recommended for visualization/mapping
- street_name migrated to has_label + Label (2026-01-17, Rule 53/56)
- street_address removed - use house_number + has_label instead
see_also:
- https://www.w3.org/TR/vcard-rdf/#d4e936
- https://schema.org/PostalAddress
- https://www.w3.org/ns/locn#Address
- https://www.gleif.org/ontology/Base/PhysicalAddress
- AddressType
- AddressTypes
- AddressComponent
Reference in a new issue View git blame Copy permalink