Interface LocationFacet

  • All Superinterfaces:
    org.gcube.informationsystem.base.reference.Element, org.gcube.informationsystem.model.reference.entities.Entity, org.gcube.informationsystem.base.reference.entities.EntityElement, org.gcube.informationsystem.model.reference.ERElement, org.gcube.informationsystem.model.reference.entities.Facet, org.gcube.informationsystem.base.reference.IdentifiableElement, org.gcube.informationsystem.model.reference.ModelElement, org.gcube.informationsystem.base.reference.SchemaMixedElement, Serializable
    All Known Implementing Classes:
    LocationFacetImpl

    @TypeMetadata(name="LocationFacet",
                  description="LocationFacet captures information about the geographic location characterizing the associated resource. It should not be confused with {@link CoverageFacet}. LocationFacet describes where a resource is located, optionally using GeoJSON spatial geometry. It is typically used to locate a data centre or to represent the geographic reference of a legal or organizational body acting as an actor within the infrastructure.",
                  version="1.1.0")
    @Change(version="1.1.0",description="General revision of the facet to improve clarity and usability; removed \'latitude\' and \'longitude\' in favor of \'spatialGeometry\' for greater flexibility; removed \'country\' to avoid collisions with \'location\' when the intended location represents a country; \'location\' is no longer limited to a city name and can represent any human-readable location description.") @Change(version="1.0.0",description="First Version")
    public interface LocationFacet
    extends org.gcube.informationsystem.model.reference.entities.Facet
    LocationFacet captures information on a physical area characterising the resource it is associated with. This should not be confused with CoverageFacet The LocationFacet provides information of a location (eventually using latitude and longitude), instead CoverageFacet provide a way to to define the spatial or the temporal extent the resource represent. It is mainly used to locate a data centre or to the geographic references of a legal body playing the role of an actor in the infrastructure. https://wiki.gcube-system.org/gcube/GCube_Model#Location_Facet
    Author:
    Luca Frosini (ISTI - CNR), Francesco Mangiacrapa (ISTI - CNR)
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static String LOCATION_PROPERTY
      The name of 'location' property
      static String NAME
      The name associated with this facet
      static String SPATIAL_GEOMETRY_PROPERTY
      The name of 'spatialGeometry' property
      static String VERSION
      The version associated with this facet
      • Fields inherited from interface org.gcube.informationsystem.base.reference.Element

        DATETIME_PATTERN, TYPE_PROPERTY
      • Fields inherited from interface org.gcube.informationsystem.model.reference.ERElement

        CONTEXTS_PROPERTY
      • Fields inherited from interface org.gcube.informationsystem.base.reference.IdentifiableElement

        ID_PROPERTY, METADATA_PROPERTY
      • Fields inherited from interface org.gcube.informationsystem.model.reference.ModelElement

        EXPECTED_TYPE_PROPERTY, SUPERTYPES_PROPERTY
    • Method Summary

      All Methods Static Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      static LocationFacet getDefaultInstance()
      Returns a default instance of LocationFacet
      String getLocation()
      A human english name for the location, e.g., a city name, a country name, a site name, a region name, etc.
      org.gcube.com.fasterxml.jackson.databind.node.ObjectNode getSpatialGeometry()
      Spatial Geometry in GeoJSON format
      void setLocation​(String location)
      Sets A human english name for the location, e.g., a city name, a country name, a site name, a region name, etc.
      void setSpatialGeometry​(org.gcube.com.fasterxml.jackson.databind.node.ObjectNode spatialGeometry)
      Sets the Spatial Geometry in GeoJSON format
      • Methods inherited from interface org.gcube.informationsystem.base.reference.Element

        getTypeName
      • Methods inherited from interface org.gcube.informationsystem.base.reference.entities.EntityElement

        getID, getMetadata, setID, setMetadata
      • Methods inherited from interface org.gcube.informationsystem.model.reference.ERElement

        getContexts
      • Methods inherited from interface org.gcube.informationsystem.model.reference.entities.Facet

        getAdditionalProperties, getAdditionalProperty, setAdditionalProperties, setAdditionalProperty
      • Methods inherited from interface org.gcube.informationsystem.model.reference.ModelElement

        getExpectedtype, getSupertypes
    • Method Detail

      • getDefaultInstance

        static LocationFacet getDefaultInstance()
        Returns a default instance of LocationFacet
        Returns:
        a default instance of LocationFacet
      • getLocation

        @ISProperty(name="location",
                    description="A human english name for the location, e.g., a city name, a country name, a site name, a region name, etc.")
        String getLocation()
        A human english name for the location, e.g., a city name, a country name, a site name, a region name, etc.
        Returns:
        the location
      • setLocation

        void setLocation​(String location)
        Sets A human english name for the location, e.g., a city name, a country name, a site name, a region name, etc.
        Parameters:
        location - the location
      • getSpatialGeometry

        @ISProperty(name="spatialGeometry",
                    description="Spatial Geometry in GeoJSON format")
        org.gcube.com.fasterxml.jackson.databind.node.ObjectNode getSpatialGeometry()
        Spatial Geometry in GeoJSON format
        Returns:
        the spatial geometry
      • setSpatialGeometry

        void setSpatialGeometry​(org.gcube.com.fasterxml.jackson.databind.node.ObjectNode spatialGeometry)
        Sets the Spatial Geometry in GeoJSON format
        Parameters:
        spatialGeometry - the spatial geometry