Skip to main content

Dataset Card

Purpose

A dataset card is a detailed metadata structure returned by a dataset card request to the Dateno API. It provides full metadata for a dataset, including all resources, source metadata, descriptive fields, and scoring values.

Dataset cards offer more comprehensive metadata than dataset descriptors, including a long description and a complete list of resource descriptors.

Structure

Each catalog card is a JSON object that provides structured metadata about a catalog indexed in Dateno. It contains the following top-level parts. Each part describes a specific aspect of the catalog.

PropertyDescription
idUnique identifier of the dataset in the Dateno registry
resourcesList of resource descriptors
sourceCatalog metadata
datasetDataset metadata assigned in the registry
scoresNumeric scores used for ranking and filtering in search results

resources

A list of resource descriptors representing the dataset’s associated information items—such as data files, external links, or service endpoints.

source

Describes the catalog and organization that published the dataset.

PropertyDescription
schemaPlain string indicating the source schema (e.g., ckan, arcgishub)
uidUnique identifier of the catalog in Dateno
owner_nameName of the publisher
softwareDirectory entry describing the maintenance software
catalog_typeDirectory entry identifying the catalog type
nameName of the catalog
macroregionsArray of directory entries for macroregions (see dataset attributes)
countriesArray of directory entries for countries
subregionsArray of directory entries for subregions
langsArray of directory entries for languages
owner_typePlain string describing the type of organization (e.g., "Central government", "Academy")
urlURL of the original catalog

TIP
Dataset descriptors and dataset cards include basic metadata about the associated catalog. To retrieve more comprehensive metadata about a specific catalog use the Fetch Single Catalog request in the Dateno API. Use the uid value with the Fetch Single Catalog request to retrieve full catalog metadata.

dataset

Describes the metadata assigned to the dataset in the registry.

PropertyDescription
titleTitle of the dataset
short_textA short summary used for preview or search results
descriptionFull-length description of the dataset’s content and purpose
formatsList of data formats of files provided in the dataset (e.g., .csv, .json)
tagsList of user-supplied keywords
topicsNormalized topics assigned by indexer
topics_originalRaw topics from the source catalog
geotopicsGeospatial topics if assigned
urlLink to the original dataset page
num_resourcesNumber of resources in the dataset
date_createdDate and time the dataset was created
date_changedDate and time the dataset was last updated
datatypesData types describing the nature of data
has_archiveBoolean flag indicating whether the dataset is an archive file
responsibleArray of responsible parties (e.g., publishers or creators)
idInternal identifier of the dataset

scores

Contains numeric scores used to rank datasets in the search results.

PropertyDescription
feature_scoreA composite score used to order and prioritize results

Example

{
"resources": [
{
"name": "ArcGIS Hub Dataset",
"format": null,
"mimetype": "text/html",
"d_ext": "",
"d_mime": "text/HTML",
"url": "https://rigis-edc.opendata.arcgis.com/maps/edc::urban-services-boundary"
},
{
"name": "ArcGIS GeoService",
"format": null,
"mimetype": "application/json",
"d_ext": ".json",
"d_mime": "application/json",
"url": "https://services2.arcgis.com/S8zZg9pg23JUEexQ/arcgis/rest/services/Urban_Services_Boundary/FeatureServer/0"
},
{
"name": null,
"format": null,
"mimetype": null,
"url": "http://www.planning.ri.gov"
},
{
"name": "RI_USB06.zip",
"format": null,
"mimetype": null,
"d_ext": ".zip",
"d_mime": "application/zip",
"url": "https://data.rigis.org/plan/RI_USB06.zip"
},
{
"name": "CSV",
"format": null,
"mimetype": "text/csv",
"d_ext": ".csv",
"d_mime": "text/csv",
"url": "https://rigis-edc.opendata.arcgis.com/api/download/v1/items/847dae37f36e4b8dbbee806d2b8dbdc7/csv?layers=0"
},
{
"name": "GeoJSON",
"format": null,
"mimetype": "application/vnd.geo+json",
"d_ext": ".geojson",
"d_mime": "application/vnd.geo+json",
"url": "https://rigis-edc.opendata.arcgis.com/api/..."
},
{
"name": "Shapefile",
"format": null,
"mimetype": "application/zip",
"d_ext": ".zip",
"d_mime": "application/zip",
"url": "https://rigis-edc.opendata.arcgis.com/api..."
},
{
"name": "KML",
"format": null,
"mimetype": "application/vnd.google-earth.kml+xml",
"d_ext": ".kml",
"d_mime": "application/vnd.google-earth.kml+xml",
"url": "https://rigis-edc.opendata.arcgis.com/api..."
}
],
"int_id": "https://www.arcgis.com/home/...",
"source": {
"schema": "dcatus11",
"uid": "cdi00003935",
"owner_name": "Environmental Data Center",
"software": {
"name": "ArcGIS Hub",
"id": "arcgishub"
},
"catalog_type": "Geoportal",
"name": "RIGIS",
"macroregions": [
{
"name": "Northern America",
"id": "021"
}
],
"langs": [
{
"name": "English",
"id": "EN"
}
],
"countries": [
{
"name": "United States",
"id": "US"
}
],
"subregions": [],
"owner_type": "Unknown",
"url": "https://rigis-edc.opendata.arcgis.com/"
},
"id": "92ecad2c7fe1931cc13c29f28840f92269ae6d435e154a45a4e14734bef14d14",
"scores": {
"feature_score": 98
},
"dataset": {
"topics_original": [
"geospatial"
],
"geotopics": [],
"formats": [
".json",
".zip",
".csv",
".geojson",
".kml"
],
"topics": [
"Regions and cities"
],
"date_created": "2017-06-28T17:26:38.000Z",
"short_text": "The Urban Services Boundary was developed for the Rhode Island",
"num_resources": 8,
"description": "<p>The Urban Services Boundary was developed for the
Rhode\nIsland Statewide Planning Program as part of a GIS
overlay analysis of land\nsuitability and availability for
Figure 121-02-(01), Rhode...</p>",
"title": "Urban Services Boundary",
"date_changed": "2021-05-28T12:39:33.520Z",
"url": "https://rigis-edc.opendata.arcgis.com/...",
"datatypes": [
"other",
"data",
"archives",
"geodata"
],
"has_archive": false,
"tags": [
"PLAN",
"RIGIS",
"Rhode Island",
"GNIS",
"land use",
"future state land use",
"planning",
"growth management",
"infrastructure"
],
"responsible": [
{
"role": "Publisher",
"title": "Rhode Island Division of Planning"
}
],
"id": "https://www.arcgis.com/home/..."
}