Arkisto-Platform / describo-data-packs

https://arkisto-platform.github.io/describo-data-packs/
GNU General Public License v3.0
0 stars 0 forks source link

Extra required property definitions #13

Open marcolarosa opened 2 years ago

marcolarosa commented 2 years ago

I've had to make some changes to the datastructure of the glottolog and austlang data packs. When looking up the austlang data pack, if a match is found for that language in glottolog and ethnologue (iso639-3) then the entry looks as follows:

  {
        "@id": "https://collection.aiatsis.gov.au/austlang/language/A121",
        "@type": "Language",
        "languageCode": "A121",
        "name": "Ngardi",
        "geojson": {
            "@id": "#Ngardi",
            "@type": "GeoCoordinates",
            "geojson": "{\"type\":\"Feature\",\"name\":\"Ngardi\",\"geometry\":{\"type\":\"GeoCoordinates\",\"coordinates\":[\"\",\"\"]}}"
        },
        "source": "Austlang",
        "sameAs": [
            { "@id": "https://glottolog.org/resource/languoid/id/ngar1288" },
            { "@id": "https://www.ethnologue.com/language/rxd" }
        ],
        "alternateName": "",
        "glottologCode": "ngar1288",
        "iso639-3": "rxd"
    },

Of particular note is the sameAs property which has links to the related entries in glotto / ethnologue and the two extra properties glottologCode and iso639-3 which allow lookups on this entry by those codes. I don't think either of those two properties have definitions.

Likewise in glottolog - but with references to austlang and ethnologue:

 {
        "@id": "https://glottolog.org/resource/languoid/id/ngar1288",
        "@type": "Language",
        "languageCode": "ngar1288",
        "name": "Ngardi",
        "geojson": {
            "@id": "#Ngardi",
            "@type": "GeoCoordinates",
            "name": "Geographical coverage for Ngardi",
            "geojson": "{\"type\":\"Feature\",\"name\":\"Ngardi\",\"geometry\":{\"type\":\"GeoCoordinates\",\"coordinates\":[\"-21.0231\",\"129.0308\"]}}"
        },
        "source": "Glottolog",
        "sameAs": [
            { "@id": "https://www.ethnologue.com/language/rxd" },
            { "@id": "https://collection.aiatsis.gov.au/austlang/language/A121" }
        ],
        "alternateName": "",
        "iso639-3": "rxd",
        "austlangCode": "A121"
    },

In this case we have the sameAs property with the respective links and the properties iso639-3 (as above) and austlangCode.

marcolarosa commented 2 years ago

Further to this please add two properties for the country data pack:

{
    '@id': 'https://www.ethnologue.com/country/AD',
    '@type': 'Country',
    name: 'Andorra',
    iso2: 'AD',
    iso3: 'AND',
    geojson: {
      '@id': '#Andorra',
      '@type': 'GeoShape',
      geojson: '{"type":"Feature","properties":{"ADMIN":"Andorra","ISO_A3":"AND"},"geometry":{"type":"Polygon","coordinates":[[[1.707006470000067,42.5027814740001],[1.697498006000075,42.49446156900012],[1.68633589600006,42.49061167500008],[1.674243611000065,42.49050832100005],[1.662358032000043,42.493712260000024],[1.659774210000137,42.49681284600007],[1.656983683000078,42.49763966900008],[1.653986450000048,42.4965286260001],[1.650369100000063,42.49340220200014],[1.639517049000119,42.46642710400002],[1.607477661000104,42.456427714000085],[1.544432414000085,42.45035573400014],[1.538851359000063,42.44565317800007],[1.534510539000081,42.439917094000094],[1.528206014000091,42.43423268600006],[1.516630493000122,42.42950429300009],[1.508465617000127,42.42867747000005],[1.447900838000066,42.43464609800009],[1.436428670000055,42.44095062300008],[1.436428670000055,42.4534821580001],[1.407593221000099,42.48676178000005],[1.424543090000014,42.49247202600009],[1.43022749800005,42.493557231000096],[1.449967895000043,42.50407338400004],[1.446557251000087,42.51988637400004],[1.428987264000114,42.531461894000074],[1.406456339000101,42.529239808000085],[1.409763631000089,42.540608622000065],[1.426300090000098,42.56179596000004],[1.426403442000122,42.56564585400008],[1.418031860000042,42.56983164500011],[1.419272095000082,42.579262594000085],[1.424853150000104,42.5893653360001],[1.42929732200011,42.595385641000064],[1.451414836000112,42.60205190100007],[1.466814412000105,42.641455180000065],[1.498440389000081,42.64024078400004],[1.527792602000062,42.6485348520001],[1.543088827000133,42.64936167400003],[1.597349081000061,42.62192148900007],[1.608304484000144,42.61812327100003],[1.721992635000049,42.60985504200008],[1.713310995000086,42.58954620400007],[1.729434041000047,42.58200144500012],[1.752688435000067,42.576678772000065],[1.761107147000132,42.567646197000016],[1.765090780000151,42.56337209100005],[1.739976033000119,42.561640930000095],[1.721682577000138,42.54851511600003],[1.710623820000137,42.527741191000075],[1.707006470000067,42.5027814740001]]]}}'
    }
  }

In this case iso2 and iso3. These are not defined in schema.org and until now we have been using alternateName for the iso2 value which i don't think is appropriate.

ptsefton commented 2 years ago

These can definitely be added - but how about we use the same name as in geojson - but following schema.org practivce would be lowercase (cos it is a property) isoA3 isoA2.


Dr Peter Sefton Senior Technical Advisor, School of Languages and Culture Mobile: 0404 096 932


From: Marco La Rosa @.> Sent: Monday, September 26, 2022 15:27 To: Arkisto-Platform/describo-data-packs @.> Cc: Peter Sefton @.>; Assign @.> Subject: Re: [Arkisto-Platform/describo-data-packs] Extra required property definitions (Issue #13)

Further to this please add two properties for the country data pack:

{ @.': 'https://www.ethnologue.com/country/AD', @.': 'Country', name: 'Andorra', iso2: 'AD', iso3: 'AND', geojson: { @.': '#Andorra', @.': 'GeoShape', geojson: '{"type":"Feature","properties":{"ADMIN":"Andorra","ISO_A3":"AND"},"geometry":{"type":"Polygon","coordinates":[[[1.707006470000067,42.5027814740001],[1.697498006000075,42.49446156900012],[1.68633589600006,42.49061167500008],[1.674243611000065,42.49050832100005],[1.662358032000043,42.493712260000024],[1.659774210000137,42.49681284600007],[1.656983683000078,42.49763966900008],[1.653986450000048,42.4965286260001],[1.650369100000063,42.49340220200014],[1.639517049000119,42.46642710400002],[1.607477661000104,42.456427714000085],[1.544432414000085,42.45035573400014],[1.538851359000063,42.44565317800007],[1.534510539000081,42.439917094000094],[1.528206014000091,42.43423268600006],[1.516630493000122,42.42950429300009],[1.508465617000127,42.42867747000005],[1.447900838000066,42.43464609800009],[1.436428670000055,42.44095062300008],[1.436428670000055,42.4534821580001],[1.407593221000099,42.48676178000005],[1.424543090000014,42.49247202600009],[1.43022749800005,42.493557231000096],[1.449967895000043,42.50407338400004],[1.446557251000087,42.51988637400004],[1.428987264000114,42.531461894000074],[1.406456339000101,42.529239808000085],[1.409763631000089,42.540608622000065],[1.426300090000098,42.56179596000004],[1.426403442000122,42.56564585400008],[1.418031860000042,42.56983164500011],[1.419272095000082,42.579262594000085],[1.424853150000104,42.5893653360001],[1.42929732200011,42.595385641000064],[1.451414836000112,42.60205190100007],[1.466814412000105,42.641455180000065],[1.498440389000081,42.64024078400004],[1.527792602000062,42.6485348520001],[1.543088827000133,42.64936167400003],[1.597349081000061,42.62192148900007],[1.608304484000144,42.61812327100003],[1.721992635000049,42.60985504200008],[1.713310995000086,42.58954620400007],[1.729434041000047,42.58200144500012],[1.752688435000067,42.576678772000065],[1.761107147000132,42.567646197000016],[1.765090780000151,42.56337209100005],[1.739976033000119,42.561640930000095],[1.721682577000138,42.54851511600003],[1.710623820000137,42.527741191000075],[1.707006470000067,42.5027814740001]]]}}' } }

In this case iso2 and iso3. These are not defined in schema.org and until now we have been using alternateName for the iso2 value which i don't think is appropriate.

— Reply to this email directly, view it on GitHubhttps://github.com/Arkisto-Platform/describo-data-packs/issues/13#issuecomment-1257499013, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAFYTWDFQLDNVBKUGQZUJADWAEX23ANCNFSM6AAAAAAQVLDTMQ. You are receiving this because you were assigned.Message ID: @.***>

marcolarosa commented 2 years ago

Can do.

Are the extra language properties named sensibly? Happy for those to change too if required. I just need them to be there in some form is all.

marcolarosa commented 2 years ago

The country data pack has been updated. The documentation is @ https://arkisto-platform.github.io/describo-data-packs/global.html#CountryEntryDataFormat