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.
Property | Description |
---|---|
id | Unique identifier of the dataset in the Dateno registry |
resources | List of resource descriptors |
source | Catalog metadata |
dataset | Dataset metadata assigned in the registry |
scores | Numeric 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.
Property | Description |
---|---|
schema | Plain string indicating the source schema (e.g., ckan , arcgishub ) |
uid | Unique identifier of the catalog in Dateno |
owner_name | Name of the publisher |
software | Directory entry describing the maintenance software |
catalog_type | Directory entry identifying the catalog type |
name | Name of the catalog |
macroregions | Array of directory entries for macroregions (see dataset attributes) |
countries | Array of directory entries for countries |
subregions | Array of directory entries for subregions |
langs | Array of directory entries for languages |
owner_type | Plain string describing the type of organization (e.g., "Central government" , "Academy" ) |
url | URL 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 theuid
value with the Fetch Single Catalog request to retrieve full catalog metadata.
dataset
Describes the metadata assigned to the dataset in the registry.
Property | Description |
---|---|
title | Title of the dataset |
short_text | A short summary used for preview or search results |
description | Full-length description of the dataset’s content and purpose |
formats | List of data formats of files provided in the dataset (e.g., .csv , .json ) |
tags | List of user-supplied keywords |
topics | Normalized topics assigned by indexer |
topics_original | Raw topics from the source catalog |
geotopics | Geospatial topics if assigned |
url | Link to the original dataset page |
num_resources | Number of resources in the dataset |
date_created | Date and time the dataset was created |
date_changed | Date and time the dataset was last updated |
datatypes | Data types describing the nature of data |
has_archive | Boolean flag indicating whether the dataset is an archive file |
responsible | Array of responsible parties (e.g., publishers or creators) |
id | Internal identifier of the dataset |
scores
Contains numeric scores used to rank datasets in the search results.
Property | Description |
---|---|
feature_score | A 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/..."
}