OpenGeoMetadata (OGM) Aardvark Schema¶
Descriptive¶
- Title (R)
- Alternative Title
- Description (S)
- Language (v)
- Display Note
Credits¶
Categories¶
- Resource Class (R) (v)
- Resource Type (S) (v)
- Subject
- Theme (v)
- Keyword
Temporal ¶
Spatial ¶
- Spatial Coverage (S)
- Geometry (S)
- Bounding Box (S)
- Centroid
- Georeferenced
Relations¶
Rights¶
- Rights (S)
- Rights Holder
- License
- Access Rights (R)
Object¶
Links¶
Identifiers¶
- ID (R)
- Identifier (S)
Admin¶
- Modified (R)
- Metadata Version (R) (v)
- Suppressed
Key
(R) = Required
(C) = Conditionally Required
(S) = Suggested
(v) = Controlled Values
Access Rights¶
Label | Access Rights |
---|---|
URI | dct_accessRights_s |
Obligation | Required |
Multivalued | false |
Field type | string |
Purpose | To clarify to the user if the resource is public (any user can access) or restricted (a user will need to log in to some kind of authentication protocol) and if the application should provide a web service preview and/or a download function |
Entry Guidelines | Only one of two values are allowed: Public or Restricted. |
Commentary | This field can be set to "Public", which allows users to view and download an item, or "Restricted", which requires a user to log in to an authentication service. |
Controlled Vocabulary | yes - strict |
Example value | "Public" |
Element Set | DCMI |
Group | Rights |
Alternative Title¶
Label | Alternative Title |
---|---|
URI | dct_alternative_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To provide the user with the another title if needed |
Entry Guidelines | This could be for a secondary or original title or subtitle. |
Commentary | For discoverability, improving titles for data is encouraged. This field could be a place to keep the original title. It could also be useful for scanned maps. Some have long titles that include MARC subtitle fields, such as 245$b. Whether or not this field should appear in your GeoBlacklight item view pages can be customized in the application. |
Controlled Vocabulary | no |
Example value | ["NEZ H Districts"] |
Element Set | DCMI |
Group | Bibliographic - general |
Bounding Box¶
Label | Bounding Box |
---|---|
URI | dcat_bbox |
Obligation | Suggested |
Multivalued | false |
Field type | string |
Purpose | To support overlap ratio boosting in spatial searches |
Entry Guidelines | This should be a bounding box in this format: ENVELOPE(w,e,n,s). |
Commentary | If the locn_geometry field uses the ENVELOPE syntax, then these fields will be identical. |
Controlled Vocabulary | no |
Example value | "ENVELOPE(-111.1, -104.0, 45.0, 40.9)" |
Element Set | DCAT |
Group | Spatial |
Centroid¶
Label | Centroid |
---|---|
URI | dcat_centroid |
Obligation | Optional |
Multivalued | false |
Field type | string |
Purpose | To display the center point of a resource |
Entry Guidelines | Enter two decimal degree coordinates separated by a comma in this order: latitude,longitude. |
Commentary | This field is currently only supported by customizations to the GeoBlacklight application. |
Controlled Vocabulary | no |
Example value | "46.4218,-94.087" |
Element Set | DCAT |
Group | Spatial |
Creator¶
Label | Creator |
---|---|
URI | dct_creator_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To credit the person/organization that collected or authored the resource |
Entry Guidelines | The suggested controlled vocabulary is the Library of Congress Name Authority File. |
Commentary | This field is best reserved for instances in which an individual person has collected, produced, or generated analyses of data (as opposed to an agency releasing a data product or resource). It can be a person or an organization. |
Controlled Vocabulary | no |
Example value | ["Geological Survey (U.S.)"] |
Element Set | DCMI |
Group | Bibliographic - entity |
Date Issued¶
Label | Date Issued |
---|---|
URI | dct_issued_s |
Obligation | Optional |
Multivalued | false |
Field type | string |
Purpose | To provide the user with the date when an item was published, and for administrators to determine the age of the resource |
Entry Guidelines | A single year is the preferred format. For more precise dates, use the ISO format without the time value: YYYY-MM-DD or YYYY-MM. |
Commentary | Although the field is optional, it is often useful when a clear Temporal Coverage value is not present. For example, one may want to preserve a dataset with an uncertain lineage, but there is an indicator on a data portal on the date of last update. In most cases, the 4-digit year is sufficient. |
Controlled Vocabulary | no |
Example value | "1999" |
Element Set | DCMI |
Group | Temporal |
Date Range¶
Label | Date Range |
---|---|
URI | gbl_dateRange_drsim |
Obligation | Optional |
Multivalued | true |
Field type | string |
Purpose | To power other time widgets that use a date range |
Entry Guidelines | Enter a start date and end date in the Solr date range field convention. In JSON, the value should be formatted as a string that includes the brackets, rather than as an array or list containing a string. Incorrect: ["YYYY TO YYYY"] - Correct: "[YYYY TO YYYY]" |
Commentary | This field is not yet supported by GeoBlacklight, but the application can be customized to use it. |
Controlled Vocabulary | no |
Example value | "[1980 TO 1995]" |
Element Set | GBL |
Group | Temporal |
Description¶
Label | Description |
---|---|
URI | dct_description_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide the user with a summary of the resource |
Entry Guidelines | At minimum, this is a reiteration of the title in sentence format. Other relevant information, such as data creation methods, data sources, and special licenses, may also be included. Description is a plain text field by default. |
Commentary | This field is the second-most prominent value (after Title) that users see when search or browsing for items. Although not required, it is strongly recommended. If the description is minimal or lacking, it can be improved by concatenating available metadata fields, such as title, date, format, and place. This is a plain text field, so html code is not supported here unless the application is customized. |
Controlled Vocabulary | no |
Example value | "This polygon shapefile represents boundaries of election districts in New York City. It was harvested from the NYC Open Data Portal." |
Element Set | DCMI |
Group | Bibliographic - general |
Display Note¶
Label | Display Note |
---|---|
URI | gbl_displayNote_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To highlight additional information about a resource, such as warnings or tips for using the data. |
Entry Guidelines | Prefix the string with "Warning:", "Info:", or "Tip:" to specify the type of note. Future versions of GeoBlacklight will use such prefixes to control the style of the displayed note. Styles and additional prefixes (for example, in other languages) can be added in the GeoBlacklight config. |
Commentary | This field is currently only supported by customizations to the GeoBlacklight application. On the item page, text in this field will be prominently displayed in a shaded box just after the title. |
Controlled Vocabulary | no |
Example value | ["Warning: This text (starting with 'This text') will be displayed in a red box","Info: This text (starting with 'This text') will be displayed in a blue box","Tip: This text (starting with 'This text') will be displayed in a green box","This is text without a tag and it will be assigned the default 'note' style"] |
Element Set | DCMI |
Group | Bibliographic - general |
File Size¶
Label | File Size |
---|---|
URI | gbl_fileSize_s |
Obligation | Optional |
Multivalued | false |
Field type | string |
Purpose | To inform the user of the size of the file download |
Entry Guidelines | Enter the size in megabytes. |
Commentary | This field is intended to give users a sense of how large the data or image they are interested in downloading, and serves to alert users about huge files. |
Controlled Vocabulary | no |
Example value | "25.96 MB" |
Element Set | GBL |
Group | Distribution |
Format¶
Label | Format |
---|---|
URI | dct_format_s |
Obligation | Conditionally Required |
Multivalued | false |
Field type | string |
Purpose | To display to the user the name of the file type as a text string in the download button |
Entry Guidelines | Required if the download URL is configured as a single key:value pair. |
Commentary | See recommended values below. This field is required for basic download functionality. |
Controlled Vocabulary | yes - not strict |
Example value | "Shapefile" |
Element Set | DCMI |
Group | Distribution |
Format Recommended Values¶
- ArcGRID
- CD-ROM
- DEM
- DVD-ROM
- Feature Class
- Geodatabase
- GeoJPEG
- GeoJSON
- GeoPackage
- GeoPDF
- GeoTIFF
- JPEG
- JPEG2000
- KML
- KMZ
- LAS
- LAZ
- Mixed
- Mixed
- MrSID
- PNG
- Pulsewaves
- Raster Dataset
- Shapefile
- SQLite Database
- Tabular Data
- TIFF
Geometry¶
Label | Geometry |
---|---|
URI | locn_geometry |
Obligation | Suggested |
Multivalued | false |
Field type | string |
Purpose | To display the extent of the resource and to power the map search |
Entry Guidelines | This may be a bounding box or more complex geometry. For a bounding box, it should use the ENVELOPE(w,e,n,s) syntax. For a more complex geometry, it should use the WKT ("well-known text") POLYGON or MULTIPOLYGON syntax. Note that WKT polygon vertices should be defined in counter-clockwise order. |
Commentary | Since this field is not repeatable, multiple polygons should be represented using the WKT "MULTIPOLYGON" syntax. Geometries that span the 180th Meridian, aka the Antimeridian, should be broken up into multiple bounding boxes or polygons for each side of the earth's hemisphere. This is because Solr, the underlying indexer for GeoBlacklight, can not interpret these coordinates correctly and will display the geometry improperly (horizontally flipped). |
Controlled Vocabulary | no |
Example value | Simple bounding box: "ENVELOPE(-111.1, -104.0, 45.0, 40.9)"Bermuda Triangle: "POLYGON((-80 25, -65 18, -64 33, -80 25))"Split bounding box for Alaska: "MULTIPOLYGON (((-179.3 51.1, -129.9 51.1, -129.9 71.5, -179.3 71.5, -179.3 51.1)),((172.3 51.2, 179.9 51.2, 179.9 53.1, 172.3 53.1, 172.3 51.2)))" |
Element Set | LOCN |
Group | Spatial |
Georeferenced¶
Label | Georeferenced |
---|---|
URI | gbl_georeferenced_b |
Obligation | Optional |
Multivalued | false |
Field type | boolean or string |
Purpose | To indicate whether or not a scanned map or other imagery has a georeferenced version |
Entry Guidelines | Only one of two values are allowed: true or false. |
Commentary | This field can be a shortcut for users to find georeferenced maps. Administrators can also employ the Source field to link a paper map with its scan (e.g. a TIFF) and its georeferenced version (e.g. a GeoTIFF). |
Controlled Vocabulary | yes - strict |
Example value | false or "false" |
Element Set | GBL |
Group | Administrative |
ID¶
Label | ID |
---|---|
URI | id |
Obligation | Required |
Multivalued | false |
Field type | string |
Purpose | To provide a unique alpha-numeric ID for the item that will act as the primary key in Solr and to create a unique landing page for the item |
Entry Guidelines | This string must be a globally unique value. The value should be alpha-numeric characters separated by dashes. |
Commentary | This field makes up the URL for the resource in GeoBlacklight. It is visible to the user and is used to create permalinks. The value should be alpha-numeric characters separated by dashes. If having a readable slug is desired, it is common to use the form institution-keyword1-keyword2. It should also be globally unique across all institutions in your GeoBlacklight index. |
Controlled Vocabulary | no |
Example value | "princeton-rv042w38t" |
Element Set | GBL |
Group | Administrative |
Identifier¶
Label | Identifier |
---|---|
URI | dct_identifier_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide a general purpose field for identifiers |
Entry Guidelines | This may include a DOI, catalog number, and/or other system number. |
Commentary | This is a general purpose field that can contain one or more persistent identifers or permalinks. At least one value would be ideally a persistent identifier or permalink (such as a PURL or Handle. Additional values can be for other identifiers used by the resource, such as the call number, OCLC number, or other system identifier. This field is not displayed in the interface. |
Controlled Vocabulary | no |
Example value | ["5864 .L7 E635 1998 .G7"] |
Element Set | DCMI |
Group | Administrative |
Index Year¶
Label | Index Year |
---|---|
URI | gbl_indexYear_im |
Obligation | Suggested |
Multivalued | true |
Field type | array of integers |
Purpose | To power time slider widgets that rely on integers for dates |
Entry Guidelines | Enter one or more 4-digit integers. |
Commentary | nan |
Controlled Vocabulary | no |
Example value | [1980,1981,1982] |
Element Set | GBL |
Group | Temporal |
Is Part Of¶
Label | Is Part Of |
---|---|
URI | dct_isPartOf_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To link items that are a subset of another item (e.g. a page in a book) |
Entry Guidelines | Make a parent record to group records together. Enter the ID of the parent record(s). |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["77f-0001"] |
Element Set | DCMI |
Group | Relations |
Is Replaced By¶
Label | Is Replaced By |
---|---|
URI | dct_isReplacedBy_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To point the user to new item(s) |
Entry Guidelines | Enter the ID of the related item(s) that should be used instead. |
Commentary | Replaces and Is Replaced By can be used for a revised version of a research dataset where the original is needed for reference. For example, if the original dataset has already been cited somewhere, it can be retained in a repository with a clear indication that it has been superseded by a new version. |
Controlled Vocabulary | no |
Example value | ["cugir-007933"] |
Element Set | DCMI |
Group | Relations |
Is Version Of¶
Label | Version |
---|---|
URI | dct_isVersionOf_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To indicate that an item is part of a series of resources that are updated or altered and to provide a link to a different variant or adaption |
Entry Guidelines | Enter the ID of the most recent related record OR create a parent record to group versions together. |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["xyz-1234"] |
Element Set | DCMI |
Group | Relations |
Keyword¶
Label | Keyword |
---|---|
URI | dcat_keyword_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To improve search results with hidden free text tags and to give administrators a field for internal tags |
Entry Guidelines | Enter tags that will be useful for enhancing searches and interpretation. Keywords will be in the metadata, but will be hidden to the user by default. |
Commentary | These may be used for administrative purposes or to facilitate text searching without cluttering a facet or interface. They may be helpful for grouping items by an accession code or for alternate spellings of common terms. |
Controlled Vocabulary | no |
Example value | ["covid19", "vaccination rate"] |
Element Set | DCAT |
Group | Categories |
Language¶
Label | Language |
---|---|
URI | dct_language_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To provide the user with the language of the map |
Entry Guidelines | Enter a 3-letter code using the ISO 639-2 standard. |
Commentary | This field is intended to indicate the language of the dataset, map, and/or supporting documentation. |
Controlled Vocabulary | yes - not strict. Chose from the ISO 639-3 language codes documented on the Library of Congress website. https://www.loc.gov/standards/iso639-2/php/English_list.php |
Example value | ["eng"] |
Element Set | DCMI |
Group | Bibliographic - general |
License¶
Label | License |
---|---|
URI | dct_license_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To provide URI links to specific, known licenses |
Entry Guidelines | Enter only a URI. Recommended sources are Creative Commons or Open Data Commons. |
Commentary | This field is only for URIs of known licenses. Do not enter a rightsstatement.org statement here, because those belong in the Rights field. |
Controlled Vocabulary | no |
Example value | ["https://creativecommons.org/licenses/by/4.0/"] |
Element Set | DCMI |
Group | Rights |
Member Of¶
Label | Member Of |
---|---|
URI | pcdm_memberOf_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To link items that are part of a collection |
Entry Guidelines | Make a collection record to group records together. Enter the ID of the collection-level record. |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["xyz-12394"] |
Element Set | PCDM |
Group | Relations |
Metadata Version¶
Label | Metadata Version |
---|---|
URI | gbl_mdVersion_s |
Obligation | Required |
Multivalued | false |
Field type | string |
Purpose | To clarify which GeoBlacklight metadata schema is being used |
Entry Guidelines | Enter the string: Aardvark. |
Commentary | There have been two metadata schema versions for GeoBlacklight: 1.0 and Aardvark. |
Controlled Vocabulary | yes - strict |
Example value | "Aardvark" |
Element Set | GBL |
Group | Administrative |
Modified¶
Label | Modified |
---|---|
URI | gbl_mdModified_dt |
Obligation | Required |
Multivalued | false |
Field type | string |
Purpose | To inform administrators of when the metadata was last touched |
Entry Guidelines | Use the "W3C Date and Time Format" (YYYY-MM-DDThh |
Commentary | This value should indicate when the metadata (not the resource itself) was last modified. |
Controlled Vocabulary | no |
Example value | "2015-01-01T12:00:00Z" |
Element Set | GBL |
Group | Administrative |
Provider¶
Label | Provider |
---|---|
URI | schema_provider_s |
Obligation | Suggested |
Multivalued | false |
Field type | string |
Purpose | To clarify which organization is holds the resource or acts as the custodian for the metadata record and to help users understand which resources they can access |
Entry Guidelines | This field can be any string value. However, if the value corresponds to the name of an SVG icon in GeoBlacklight, the icon will display next to the title. See the GeoBlacklight documentation for more details. |
Commentary | This field was named Provenance in the GBL 1.0 Metadata schema. |
Controlled Vocabulary | yes - not strict |
Example value | "University of Minnesota" |
Element Set | schema.org |
Group | Administrative - entity |
Publisher¶
Label | Publisher |
---|---|
URI | dct_publisher_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To credit the entity that first made a new version of something available |
Entry Guidelines | The suggested controlled vocabulary is the Library of Congress Name Authority File. |
Commentary | The distinction between dc_publisher_s and dc_creator_sm for data is often vague. Publishers should be the administrative body or organization that made the original resource available, regardless of who compiled or produced the data. |
Controlled Vocabulary | no |
Example value | ["ML InfoMap (Firm)"] |
Element Set | DCMI |
Group | Bibliographic - entity |
References¶
Label | References |
---|---|
URI | dct_references_s |
Obligation | Suggested |
Multivalued | false |
Field type | string (serialized JSON) |
Purpose | To provide external URLs for accessing or describing the resource |
Entry Guidelines | This field defines external services and references using the CatInterOp approach. The field value is a serialized JSON array of key/value pairs, with keys representing namespace URI's and values the URL. See the Configure References Links page for detailed information about configuring this field. |
Commentary | All of the external links for the resource are added to This field as a serialized JSON array of key/value pairs. The download key/value pair is unique, because the value can be an array. |
Controlled Vocabulary | yes - see Reference URIs |
Example value | "{\"http://schema.org/url\":\"http://purl.stanford.edu/bm662dm5913\",\"http://schema.org/downloadUrl\":\"http://stacks.stanford.edu/file/druid:bm662dm5913/data.zip\"}" |
Element Set | DCMI |
Group | Distribution |
Relation¶
Label | Relation |
---|---|
URI | dct_relation_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To link items with a general, unspecified relationship to each other |
Entry Guidelines | Enter only the ID of the related item(s). |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["aoeu-987643"] |
Element Set | DCMI |
Group | Relations |
Replaces¶
Label | Replaces |
---|---|
URI | dct_replaces_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To point the user to deprecated item(s) |
Entry Guidelines | Enter the ID of the deprecated related item(s). |
Commentary | Replaces and Is Replaced By can be used for a revised version of a research dataset where the original is needed for reference. For example, if the original dataset has already been cited somewhere, it can be retained in a repository with a clear indication that it has been superseded by a new version. |
Controlled Vocabulary | no |
Example value | ["qrst-71717"] |
Element Set | DCMI |
Group | Relations |
Resource Class¶
Label | Resource Class |
---|---|
URI | gbl_resourceClass_sm |
Obligation | Required |
Multivalued | true |
Field type | array of strings |
Purpose | To provide a top level set of categories for classifying the item |
Entry Guidelines | Choose one or more terms from the list (see below). |
Commentary | This field is intended to help users sort between significantly different types of resources. |
Controlled Vocabulary | yes - strict |
Example value | ["Datasets"] |
Element Set | GBL |
Group | Categories |
Resource Class Controlled Values¶
- Collections
- Datasets
- Imagery
- Maps
- Web services
- Websites
- Other
Resource Type¶
Label | Resource Type |
---|---|
URI | gbl_resourceType_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide a secondary level of categories for classifying the spatial type or structure of a dataset |
Entry Guidelines | Choose one or more terms from the list (see below). Other terms are allowed. |
Commentary | This field combines an established list of terms for scanned maps (Cartographic Genres) and a custom list for geospatial data types. Additional terms are welcome - please submit them to the community for review and inclusion into the official vocabulary. |
Controlled Vocabulary | yes - not strict |
Example value | ["Point data"] |
Element Set | GBL |
Group | Categories |
Resource Type Controlled Values¶
Term | Source |
---|---|
Aerial photographs | LOC |
Aerial views | LOC |
Aeronautical charts | LOC |
Annotations | GBL |
Armillary spheres | LOC |
Astronautical charts | LOC |
Astronomical models | LOC |
Atlases | LOC |
Basemaps | GBL |
Bathymetric maps | LOC |
Block diagrams | LOC |
Bottle-charts | LOC |
Cadastral maps | LOC |
Cartographic materials | LOC |
Cartographic materials for people with visual disabilities | LOC |
Celestial charts | LOC |
Celestial globes | LOC |
Census data | LOC |
Children's atlases | LOC |
Children's maps | LOC |
Comparative maps | LOC |
Composite atlases | LOC |
Digital elevation models | LOC |
Digital maps | LOC |
Early maps | LOC |
Ephemerides | LOC |
Ethnographic maps | LOC |
Fire insurance maps | LOC |
Flow maps | LOC |
Gazetteers | LOC |
Geological cross-sections | LOC |
Geological maps | LOC |
Globes | LOC |
Gores (Maps) | LOC |
Gravity anomaly maps | LOC |
Index maps | LOC |
LiDAR | GBL |
Line data | GBL |
Linguistic atlases | LOC |
Loran charts | LOC |
Manuscript maps | LOC |
Mappae mundi | LOC |
Mental maps | LOC |
Mesh data | GBL |
Meteorological charts | LOC |
Military maps | LOC |
Mine maps | LOC |
Miniature maps | LOC |
Multi-spectral data | GBL |
Nautical charts | LOC |
Oblique photographs | GBL |
Outline maps | LOC |
Photogrammetric maps | LOC |
Photomaps | LOC |
Physical maps | LOC |
Pictorial maps | LOC |
Plotting charts | LOC |
Point cloud data | GBL |
Point data | GBL |
Polygon data | GBL |
Portolan charts | LOC |
Quadrangle maps | LOC |
Raster data | GBL |
Relief models | LOC |
Remote-sensing maps | LOC |
Road maps | LOC |
Satellite imagery | GBL |
Statistical maps | LOC |
Stick charts | LOC |
Streetview photographs | GBL |
Strip maps | LOC |
Table data | GBL |
Thematic maps | LOC |
Topographic maps | LOC |
Tourist maps | LOC |
Upside-down maps | LOC |
Wall maps | LOC |
World atlases | LOC |
World maps | LOC |
Worm's-eye views | LOC |
Zoning maps | LOC |
Rights¶
Label | Rights |
---|---|
URI | dct_rights_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide a free text field for rights information, such as usage, access, or copyright |
Entry Guidelines | Enter free text of generic, catch-all access and usage rights. It can include clickable links; all access and usage rights. |
Commentary | This field is intended to be flexible to accommodate different types of rights and disclaimers. Users are encouraged to adopt one of the rightsstatements.org statements. |
Controlled Vocabulary | no |
Example value | "All data is copyrighted by China Data Center and/or its suppliers. Derived works that include the source data must be merged with other value-added data in such a way that the derived work cannot be converted back to the original source data format. This data is licensed by UC Berkeley for research, educational, and other non-commercial use by authorized users, which include persons affiliated with UC Berkeley and walk-in users who must access the data in person at the library. https://rightsstatements.org/page/InC/1.0/?language=en" |
Element Set | DCMI |
Group | Bibliographic - general |
Rights Holder¶
Label | Rights Holder |
---|---|
URI | dct_rightsHolder_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To clarify which person or organization owns or controls the rights for this version of the item |
Entry Guidelines | Enter the name of the person or organization. If applicable, the suggested controlled vocabulary is the Library of Congress Name Authority File. |
Commentary | This field can be used for instances in which an an organization owns a digital copy of an analog resource or otherwise controls access. This is different from Provider, which refers more to the resource or metadata steward. |
Controlled Vocabulary | no |
Example value | "Johns Hopkins University Libraries" |
Element Set | DCMI |
Group | Rights |
Source¶
Label | Source |
---|---|
URI | dct_source_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To link items that have been derived from another item (e.g. a digitized shapefile from a historical map) |
Entry Guidelines | Enter the ID of the item(s) from which the resource was derived. |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["abcd-988763"] |
Element Set | DCMI |
Group | Relations |
Spatial coverage¶
Label | Spatial Coverage |
---|---|
URI | dct_spatial_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide the user with a list of searchable and selectable place names |
Entry Guidelines | Place name text strings should be specified out to the nation level. It is typical for the place name to represent the largest extent the data layer represents. Our recommended thesaurus is GeoNames. |
Commentary | It is recommended to have at least one place name for each layer that corresponds to the logical extent of the area of that layer. |
Controlled Vocabulary | no |
Example value | ["Philadelphia, Pennsylvania, United States"] |
Element Set | DCMI |
Group | Spatial |
Subject¶
Label | Subject |
---|---|
URI | dct_subject_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To provide an all-purpose field for subjects |
Entry Guidelines | Any value is allowed, but controlled vocabularies are encouraged. |
Commentary | nan |
Controlled Vocabulary | no |
Example value | ["Elections", "Voting"] |
Element Set | DCMI |
Group | Categories |
Suppressed¶
Label | Suppressed |
---|---|
URI | gbl_suppressed_b |
Obligation | Optional |
Multivalued | false |
Field type | boolean or string |
Purpose | To hide items from users in the search results. If set to True, the record will not appear in search results. It is still accessible from the Data Relations widget and via direct URL. |
Entry Guidelines | Only one of two values are allowed: true or false. |
Commentary | This field is useful for multipart items with identical metadata, such as pages in an atlas or series. |
Controlled Vocabulary | yes - strict |
Example value | true or "true" |
Element Set | GBL |
Group | Administrative |
Temporal Coverage¶
Label | Temporal Coverage |
---|---|
URI | dct_temporal_sm |
Obligation | Suggested |
Multivalued | true |
Field type | array of strings |
Purpose | To provide the user with a free text description of the time period or ranges of what is depicted in the resource |
Entry Guidelines | This is a text string and can indicate uncertainty. |
Commentary | Since this field is multi-valued, multiple strings can be used to indicate the time period the resource depicts, when the data was collected, and/or when the resources was created. |
Controlled Vocabulary | no |
Example value | ["1980-1995", "Late 20th century"] |
Element Set | DCMI |
Group | Temporal |
Theme¶
Label | Theme |
---|---|
URI | dcat_theme_sm |
Obligation | Optional |
Multivalued | true |
Field type | array of strings |
Purpose | To provide a dedicated field that is restricted to terms based on ISO Topic Categories |
Entry Guidelines | Insert one or more of the Themes from the list (see below). |
Commentary | Although ISO Topic categories are well established and widely used, the spellings of these terms vary across domains and disciplines. The Aardvark Profile uses shortened terms for better readability, and adds three new values "Events", "Imagery", and "Land Cover" (the latter two split from imageryBaseMapsEarthCover). |
Controlled Vocabulary | yes - strict |
Example value | ["Boundaries", "Land Cover"] |
Element Set | DCAT |
Group | Categories |
Theme Controlled Values¶
Theme | Related ISO Topic Category | Definition (from NOAA) |
---|---|---|
Agriculture | farming | Rearing of animals and/or cultivation of plants. Examples: agriculture, irrigation, aquaculture, plantations, herding, pests and diseases affecting crops and livestock |
Biology | biota | Flora and/or fauna in natural environment. Examples: wildlife, vegetation, biological sciences, ecology, wilderness, sealife, wetlands, habitat |
Boundaries | boundaries | Legal land descriptions. Examples: political and administrative boundaries |
Climate | climatologyMeteorologyAtmosphere | Processes and phenomena of the atmosphere. Examples: cloud cover, weather, climate, atmospheric conditions, climate change, precipitation |
Economy | economy | Economic activities, conditions and employment. Examples: production, labour, revenue, commerce, industry, tourism and ecotourism, forestry, fisheries, commercial or subsistence hunting, exploration and exploitation of resources such as minerals, oil and gas |
Elevation | elevation | Height above or below sea level. Examples: altitude, bathymetry, digital elevation models, LiDAR datasets, slope, derived products, topographic maps |
Environment | environment | Environmental resources, protection and conservation. Examples: environmental pollution, waste storage and treatment, environmental impact assessment, monitoring environmental risk, nature reserves, landscape |
Events | society; climatologyMeteorologyAtmosphere | Examples: natural disasters, concerts, races, protests, arrests, accidents, Covid cases |
Geology | geoscientificInformation | Information pertaining to earth sciences. Examples: geophysical features and processes, geology, minerals, sciences dealing with the composition, structure and origin of the earth’s rocks, risks of earthquakes, volcanic activity, landslides, gravity information, soils, permafrost, hydrogeology, erosion |
Health | health | Health, health services, human ecology, and safety. Examples: disease and illness, factors affecting health, hygiene, substance abuse, mental and physical health, health services |
Imagery | imageryBaseMapsEarthCover | Imagery of the earth's surface. Examples: aerial photos, oblique and streetview imagery, orthoimagery, satellite photos and multispectral imagery |
Inland Waters | inlandWaters | Inland water features, drainage systems and their characteristics. Examples: rivers and glaciers, salt lakes, water utilization plans, dams, currents, floods, water quality, hydrographic charts |
Land Cover | imageryBaseMapsEarthCover | Classifications about natural features on the Earth's surface. Examples: forests, wetlands, impervious surfaces, agriculture, open water |
Location | location | Positional information and services. Examples: addresses, geodetic networks, control points, postal zones and services, place names |
Military | intelligenceMilitary | Examples: Military bases, structures, activities Examples: barracks, training grounds, military transportation, information collection |
Oceans | oceans | features and characteristics of salt water bodies (excluding inland waters) Examples: tides, tidal waves, coastal information, reefs |
Property | planningCadastre | Information used for appropriate actions for future use of the land. Examples: land use maps, zoning maps, cadastral surveys, land ownership |
Society | society | Characteristics of society and cultures. Examples: settlements, anthropology, archaeology, education, traditional beliefs, manners and customs, demographic data, recreational areas and activities, social impact assessments, crime and justice, census information |
Structure | structure | Man-made construction. Examples: buildings, museums, churches, factories, housing, monuments, shops, towers |
Transportation | transportation | Means and aids for conveying persons and/or goods. Examples: roads, airports/airstrips, shipping routes, tunnels, nautical charts, vehicle or vessel location, aeronautical charts, railways |
Utilities | utilitiesCommunication | Energy, water and waste systems and communications infrastructure and services. Examples: hydroelectricity, geothermal, solar and nuclear sources of energy, water purification and distribution, sewage collection and disposal, electricity and gas distribution, data communication, telecommunication, radio, communication networks |
Title¶
Label | Title |
---|---|
URI | dct_title_s |
Obligation | Required |
Multivalued | false |
Field type | string |
Purpose | To provide the user with the name of the resource |
Entry Guidelines | Titles should include place names and dates when available. |
Commentary | The title is the most prominent metadata field that users see when browsing or scanning search results. Since many datasets are created with ambiguous or non-unique titles, it may be worth the effort to improve or enhance them. The ideal sequence of a title is something akin to Topic of Layer: Place, Year. Putting the year at the end of a title produces better search results, since titles are left-anchored. |
Controlled Vocabulary | no |
Example value | "Address Points: Ann Arbor, Michigan, 2010" |
Element Set | DCMI |
Group | Bibliographic - general |
WxS Identifier¶
Label | WxS Identifier |
---|---|
URI | gbl_wxsIdentifier_s |
Obligation | Conditional |
Multivalued | false |
Field type | string |
Purpose | To identify the layer or store for a WFS, WMS, or WCS web service so the application can construct the full web service link |
Entry Guidelines | Only the layer name is added here. The base service endpoint URLs (e.g. "https://maps-public.geo.nyu.edu/geoserver/sdr/wms") are added to the References field. |
Commentary | This value is only used when you have WxS services listed in your references field (dct_references_s). The WxS Identifer is used to point to specific layers within an OGC geospatial web service. This field is not used for ArcGIS Rest Services. |
Controlled Vocabulary | no |
Example value | "druid:vr593vj7147" |
Element Set | GBL |
Group | Distribution |