Interface LocationType


  • @UML(identifier="SI_LocationType",
         specification=ISO_19112)
    public interface LocationType
    Description of the nature (type) of a geographic identifier. Some of the mandatory properties are:
    • name (the name of the location type)
    • identification (the nature of the geographic identifier, for example name or code)
    • definition (the meaning of the location type)
    • territory of use (geographic area within which the location type occurs)
    • owner (who is responsible for this location type)

    Location types shall be immutable: a new version of the location type shall be created whenever any change occurs to any of its attributes.

    Since:
    3.1
    See Also:
    Location
    • Method Detail

      • getName

        @UML(identifier="name",
             obligation=MANDATORY,
             specification=ISO_19112)
        InternationalString getName()
        Name of the location type.
        Examples: “administrative area”, “town”, “locality”, “street”, “property”.
        Returns:
        name of the location type.
      • getTheme

        @UML(identifier="theme",
             obligation=MANDATORY,
             specification=ISO_19112)
        InternationalString getTheme()
        Property used as the defining characteristic of the location type.
        Examples: “local administration” for administrative areas, “built environment” for towns or properties, “access” for streets, “electoral”, “postal”.
        Returns:
        property used as the defining characteristic of the location type.
        See Also:
        ReferenceSystemUsingIdentifiers.getTheme()
      • getIdentifications

        @UML(identifier="identification",
             obligation=MANDATORY,
             specification=ISO_19112)
        Collection<? extends InternationalString> getIdentifications()
        Method(s) of uniquely identifying location instances.
        Examples: “name”, “code”, “unique street reference number”, “geographic address”. A location using “name” identifications may have the “Spain” geographic identifier, and a location using “postcode” identifications may have the “SW1P 3AD” geographic identifier.
        Returns:
        method(s) of uniquely identifying location instances.
        See Also:
        Location.getGeographicIdentifier()
      • getDefinition

        @UML(identifier="definition",
             obligation=MANDATORY,
             specification=ISO_19112)
        InternationalString getDefinition()
        The way in which location instances are defined. The definition of the location type shall be in the form of one of the following:
        • an area defined by a set of boundaries, for example countries defined by their borders;
        • a single feature, for example a street defined by its centre line, or a junction of two such streets;
        • a collection of smaller features, for example trade areas defined by groups of countries.
        Where a location type is defined as a collection of smaller units, an instance of that location need not have a well-defined boundary, for example a postal code defined as a collection of postal delivery points.
        Returns:
        the way in which location instances are defined.
      • getTerritoryOfUse

        @UML(identifier="territoryOfUse",
             obligation=MANDATORY,
             specification=ISO_19112)
        GeographicExtent getTerritoryOfUse()
        Geographic area within which the location type occurs.
        Examples: the geographic domain for a location type “rivers” might be “North America”.
        Returns:
        geographic area within which the location type occurs.
        See Also:
        Gazetteer.getTerritoryOfUse(), ReferenceSystemUsingIdentifiers.getDomainOfValidity()
      • getParents

        @UML(identifier="parent",
             obligation=OPTIONAL,
             specification=ISO_19112)
        Collection<? extends LocationType> getParents()
        Parent location types (location types of which this location type is a sub-division). A location type can have more than one possible parent. For example the parent of a location type named “street” could be “locality”, “town” or “administrative area”.
        Returns:
        parent location types, or an empty collection if none.
        See Also:
        Location.getParents()
      • getChildren

        @UML(identifier="child",
             obligation=OPTIONAL,
             specification=ISO_19112)
        Collection<? extends LocationType> getChildren()
        Child location types (location types which sub-divides this location type).
        Returns:
        child location types, or an empty collection if none.
        See Also:
        Location.getChildren()