Skip to content

Latest commit

 

History

History
129 lines (90 loc) · 9.03 KB

05-vocabularies.adoc

File metadata and controls

129 lines (90 loc) · 9.03 KB

Vocabularies

This model requires the use of vocabularies to provide values for some predicates. Values from a Geocode role type vocabulary must be used to provide value for a Geocode’s [additionalType] predicate indicating the role that a Geocode plays, and similarly, values from a lifecycle stages vocabulary must be used to provide values for a Lifecycle Stage’s [additionalType] predicate, indicating specialised lifecycle stage type. [additionalType] is frequently use to provide specialised typing for instances of classes.

Note
See the example for [Address] where vocabulary concepts are used for both Geocode’s and Lifecycle Stage’s [additionalType] predicates.

Wherever in the model the range value for a predicate is given as a skos:Concept, this indicates that a vocabulary must be used as opposed to literal (text, numerical) values. skos:Concept objects are presented within skos:ConceptScheme resources, which are controlled vocabularies.

Particular vocabularies MUST be used within certain contexts of use of this model. The following subsections per known use context indicate which particular vocabularies must be used, where.

ICSM Australia & New Zealand Address Data Exchange

When address information formulated according to this model is exchanged within Australia & New Zealand according to the Intergovernmental Committee on Surveying & Mapping's rules, the following predicates MUST have range values selected from the indicated vocabularies.

Model Class Predicate Vocabulary

Address Model

[Address]

[hasPart]/[additionalType]

ICSM’s Address Part Types

Address Model

[Geocode]

[additionalType]

ICSM’s Geocode Roles

Lifecycle Model

Lifecycle Stage

[additionalType]

ICSM’s Lifecycle Stage Types

//// get the remainder from Anne’s documents

Vocabularies previewed here

Those defined here are:

Note
Hyperlinks to these vocabularies will be provided as soon as persistent identifiers for them are issued. Until then, the content of these vocabularies can be found within the submission to register them: https://github.com/GeoscienceAustralia/icsm-vocabs/pull/13/files.

Address Part Types

This vocabulary is an extended version of [ISO19160-1]'s Address Component Type vocabulary and is maintained outside this model. This means it can be extended by the user community (Australian & New Zealand), as needed, and without change to this model.

The vocabulary is located online at:

The original 8 concepts from ISO19160-1 are:

IRI Preferred Label Definition Deprecation note

aptiso:addressedObjectIdentifier

addressed object identifier

Identifier of the addressed object, e.g. building name or address number

Handled by Address/AddressableObject relation

aptiso:administrativeAreaName

administrative area name

Name of an administrative area

Use apt:stateOrTerritory

aptiso:countryCode

country code

ISO 3166-1 code for the country, territory, or area of geopolitical interest

Use apt:country to refer to a Country object

aptiso:countryName

country name

Name of a country

Handled by use of apt:country

aptiso:localityName

locality name

Name of a locality

Use apt:locality to refer to a Locality object

aptiso:postOfficeName

post office name

Name of a post office

Not in current Australian address use

aptiso:postcode

postcode

Code used for the sorting of mail

Use apt:postcode

aptiso:thoroughfareName

thoroughfare name

Name of a thoroughfare

Use apt:street to refer to a street object

These concepts have all been modified or completely replaced, except postcode. Replacements preference links to other complex objects, rather than simple literal data types, for example ISO19160-1’s countryCode which indicates a text code value for a country has been replaced with apt:country which indicates a country object. The use of object references rather than literal values allows for element labelling variation, such as use of abbreviated forms of a name, e.g. "USA" instead of "United Stated of America" , or different language variants, e.g. "Deutschland" instead of "Germany", where the variant information is stored as part of the object referred to.

This vocab currently (June 2024) contains terms such as the following (not the complete vocabulary):

IRI Preferred Label Definition Scope Note

apt:geographicalObject

geographical name object

A reference to a geographical object

This replaces several ISO19160-1 & GNAF values as this reference can be used to any category of Geographical Object with the name for the object used within the address this part is part of. Geographical Object categories are assigned to the Geographical Object, not any part of this address part or the address it is part of.

apt:subaddressType

sub-address type

The type of the sub-address part

Replaces GNAF’s flatTypeCode

apt:subaddressNumber

sub-address number

The number of the sub-address part

Replaces GNAF’s flatNumber

apt:subaddressNumberPrefix

sub-address number prefix

Replaces GNAF’s flatNumberPrefix

apt:subaddressNumberSuffix

sub-address number suffix

Replaces GNAF’s flatNumberSuffix

…​

…​

…​

…​

apt:locality

locality

A reference to a Locality object

Replaces ISO19160-1’s localityName

apt:waterFeature

water feature

A reference to a Water Feature object

New in this model

…​

…​

…​

…​

Address Lifecycle Stage Types

This vocabulary is currently as per [ISO19160-1]'s AddressLifecycleStage vocabulary, however it is expected that this vocabulary will be extended early in its use in Australia/NZ as it is know that jurisdictions within ANZ use other statuses

The Persistent web identifier for this vocabulary is:

IRI Preferred Label Definition

als:current

current

The address is recognised by the authoritative jurisdiction and is in use

als:reserved

reserved

The address is recognised by the authoritative jurisdiction but is not yet in use

als:retired

retired

The address was recognised by the authoritative jurisdiction but is no longer in use

als:proposed

proposed

The address has been suggested for use but not yet accepted

als:rejected

rejected

The address has been ruled not for use

als:unknown

unknown

The stage of this Address' life is unknown therefore it is assumes as a form of unofficial

Geocode Type

This vocabulary was derived from the geocode types given as reference values in the [GNAF].

This is only a partial rendering of the vocabulary - a static list of the top concepts as they were in June, 2023 - provided to give an indicate of values, not to be an exhaustive list of values.

The Persistent web identifier for this vocabulary is:

IRI Preferred Label Definition

gt:building-access-point

Building Access Point

Point of access to the building

gt:building-centroid

Building Centroid

Point as centre of building and lying within its bounds (e.g. for u-shaped building)

gt:centreline-dropped-frontage

Centreline Dropped Frontage

A point on the road centre-line opposite the centre of the road frontage of an address site

gt:driveway-frontage

Driveway Frontage

Centre of driveway on address site frontage

gt:emergency-access

Emergency Access

Specific building or address site access point for emergency services

gt:emergency-access-secondary

Emergency Access Secondary

Specific building or address site secondary access point for emergency services

gt:front-door-access

Front Door Access

Front door of building

gt:frontage-centre

Frontage Centre

Point on the centre of the address site frontage

gt:frontage-centre-setback

Frontage Centre Setback

A point set back from the centre of the road frontage within an address site

gt:letterbox

Letterbox

Place where mail is deposited

gt:property-access-point

Property Access Point

Access point (centre of) at the road frontage of the address site

gt:property-access-point-setback

Property Access Point Setback

Centre of driveway on address site frontage

gt:property-centroid

Property Centroid

Point of centre of parcels making up an address site and lying within its boundaries (e.g. for l-shaped address site)

gt:service-connection-point

Service Connection Point

The utility connection point (e.g. box, or underground chamber)

gt:service-meter

Service Meter

The utility meter (e.g. box, or underground chamber)

gt:unit-centroid

Unit Centroid

Point at centre of unit and lying within its bounds (e.g. for u-shaped unit)