generate schema.org Dataset & DataPackage metadata

[derhuerst]

In order to make the generated GBFS feeds discoverable and indexable by data catalogs, a schema.org Dataset & a DataPackage should be generated for each of them.

[derhuerst]

draft DataPackage:

{
	"datapackage_version": "1.0-beta.10",
	"name": "barshare-gbfs",
	"title": "BARShare GBFS",
	"description": "GBFS-Datensatz für BARShare, das Sharing-Angebot der Kreiswerke Barnim.",
	"homepage": "https://opendata.bbnavi.de/barshare/index.html",
	"keywords": [
		"GBFS",
		"mobility"
	],
	"publisher": {
		"name": "DigitalAgentur Brandenburg GmbH",
		"web": "https://www.digital-agentur.de"
	},
	"maintainers": [
		{
			"name": "DigitalAgentur Brandenburg GmbH",
			"web": "https://www.digital-agentur.de"
		}
	],
	"licenses": [
		{
			"type": "CC0-1.0",
			"url": "https://creativecommons.org/publicdomain/zero/1.0/"
		}
	],
	// todo: version
	"resources": [
		{
			"path": "gbfs.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/gbfs.json"
		},
		{
			"path": "station_information.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/station_information.json"
		},
		{
			"path": "station_status.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/station_status.json"
		},
		{
			"path": "free_bike_status.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/free_bike_status.json"
		},
		{
			"path": "system_information.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/system_information.json"
		},
		{
			"path": "vehicle_types.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/vehicle_types.json"
		},
		{
			"path": "system_pricing_plans.json",
			"mediatype": "application/json",
			"encoding": "UTF-8",
			"schema": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/system_pricing_plans.json"
		},
	],
}

[derhuerst]

draft schema.org Dataset:

{
	"@context": "http://schema.org",
	"@type": "Dataset",
	"name": "BARShare GBFS",
	"description": "GBFS-Datensatz für BARShare, das Sharing-Angebot der Kreiswerke Barnim.",
	"keywords":
	[
		"GBFS",
		"mobility"
	],
	"publisher":
	{
		"@type": "Organization",
		"name": "DigitalAgentur Brandenburg GmbH",
		"url": "https://www.digital-agentur.de"
	},
	"license": "https://creativecommons.org/publicdomain/zero/1.0/",
	"spatialCoverage":
	{
		"@type": "Place",
		"name": "Barnim",
		// todo: somehow express these:
		// "@id": "relation/62553",
		// "TMC:cid_58:tabcd_1:Class": "Area",
		// "TMC:cid_58:tabcd_1:LCLversion": "8.00",
		// "TMC:cid_58:tabcd_1:LocationCode": "336",
		// "admin_level": "6",
		// "boundary": "administrative",
		// "de:amtlicher_gemeindeschluessel": "12060",
		// "de:regionalschluessel": "12060",
		// "license_plate_code": "BAR;BER;EW",
		// "name": "Barnim",
		// "name:de": "Barnim",
		// "name:prefix": "Landkreis",
		// "name:ru": "Барним",
		// "official_name": "Landkreis Barnim",
		// "ref:nuts:3": "DE405",
		// "source": "http://wiki.openstreetmap.org/wiki/Import/Catalogue/Kreisgrenzen_Deutschland_2005",
		// "type": "boundary",
		// "wikidata": "Q6115",
		// "wikipedia": "de:Landkreis Barnim"
		"geo": {
			"@type": "GeoShape",
			"box": "13.5815424 52.5711074 13.5863822 52.5497848 13.6105975 52.5455665 13.6155224 52.5615946 13.6850976 52.5692694 13.6859643 52.5768615 13.6718817 52.5823245 13.6841455 52.5784743 13.698819 52.5902852 13.7147996 52.5872256 13.715438 52.6058376 13.7279689 52.6015646 13.7295087 52.612433 13.8279894 52.6247815 13.8444644 52.6455373 13.8376003 52.6528989 13.8484858 52.6592319 13.8502775 52.6794405 13.8587715 52.6844377 13.8507096 52.6934948 13.8365443 52.692312 13.7800157 52.6669413 13.7545373 52.7136828 13.7600442 52.7165632 13.7316042 52.7337694 13.8617255 52.758644 13.8628636 52.77198 13.8764002 52.7793588 13.8633335 52.7877154 13.9242305 52.7956397 13.9407347 52.8079424 13.9380009 52.8241718 13.9751334 52.8251976 13.9826256 52.8486098 14.0048157 52.8594823 13.9991933 52.8547633 14.0198001 52.8563731 14.0207065 52.8466475 14.0953873 52.8560553 14.0944535 52.8652439 14.1061954 52.8693614 14.0614508 52.8688465 14.0574167 52.8843767 14.075749 52.9004426 14.0808549 52.8906952 14.0953452 52.9027134 14.1269595 52.9029161 14.1299663 52.889402 14.1566419 52.8956365 14.1388419 52.951776 14.1436579 52.9613691 14.0875904 52.9627452 14.0728268 52.9588189 14.0705804 52.9491136 14.0273389 52.9565231 14.0143109 52.9316136 13.9917256 52.9319007 13.9953877 52.9360192 13.9782579 52.9489881 13.9911784 52.9598031 13.9836527 52.9669066 13.9416074 52.9552565 13.952623 52.9610428 13.9271935 52.9789295 13.9309725 52.9832626 13.9029901 52.9828268 13.9128491 52.977096 13.9003413 52.9732106 13.8625748 52.973453 13.8513865 52.9854382 13.8208706 52.9874421 13.8284397 53.020509 13.8545929 53.0175368 13.8533134 53.0322921 13.88551 53.0530256 13.8190215 53.0580651 13.8124941 53.0456553 13.7346057 53.0444316 13.7111237 53.0346469 13.682071 53.0425022 13.676286 53.0371306 13.6817793 53.0293917 13.6645167 53.0158549 13.6913409 53.0116696 13.6753893 53.0010892 13.6225712 53.0033328 13.5648941 52.989425 13.5175627 52.9885354 13.5135201 52.9750803 13.4835885 52.9637592 13.453806 52.9652058 13.4012582 52.9396385 13.3988304 52.929949 13.4264372 52.9293613 13.4168783 52.9371866 13.4366743 52.9342906 13.4101637 52.9223702 13.4090518 52.911647 13.4289151 52.9034892 13.4332903 52.916736 13.4437519 52.9099039 13.4542705 52.9129458 13.4460212 52.9177827 13.4728612 52.9185022 13.4729104 52.9065825 13.4891342 52.9008243 13.475844 52.8994826 13.4816209 52.8967527 13.4612109 52.8852524 13.5076637 52.8734783 13.4740674 52.8765924 13.4702078 52.8701396 13.4850884 52.8575564 13.4768744 52.859332 13.5230803 52.8479093 13.5093211 52.8383827 13.4942557 52.8398882 13.4985247 52.8295682 13.503461 52.8321113 13.4940573 52.8102239 13.4217861 52.8043485 13.4304171 52.7890319 13.4055463 52.7790485 13.4144093 52.7512499 13.3967292 52.744773 13.4242079 52.7343958 13.4062162 52.7256384 13.4186894 52.7205419 13.4219892 52.7099142 13.4040969 52.709628 13.4088722 52.6974335 13.3952778 52.6819661 13.4060344 52.681363 13.4000691 52.6712028 13.4239647 52.6761509 13.4134424 52.674107 13.42267 52.6694707 13.4000884 52.657228 13.4056381 52.6512976 13.3979077 52.6481146 13.4327165 52.6373793 13.4408204 52.6492654 13.4739048 52.6541195 13.450782 52.6626681 13.4794873 52.6755087 13.4745877 52.6680652 13.4884252 52.6707899 13.4907625 52.6547958 13.523022 52.6450365 13.4971188 52.6066677 13.5081184 52.5921389 13.5471255 52.5878538 13.5815424 52.5711074"
		}
	},
	"distribution": [
		{
			"@type": "DataDownload",
			"name": "GBFS",
			"contentUrl": "gbfs.json",
			"encodingFormat": "application/json",
			"schemaVersion": "https://raw.githubusercontent.com/MobilityData/gbfs-json-schema/v3.0.2/v2.2/gbfs.json"
		}
	]
}