[1] Data Resource | Data Package (v1), , https://specs.frictionlessdata.io/data-resource/
[3] Patterns | Data Package (v1), , https://specs.frictionlessdata.io/patterns/#json-data-resources
[7] >>6 この時代には Data Packages の一部として規定されていました。
[4] CKAN API における資源は Data Resource と縁戚関係にありますが、
まったく同じではありません。
[5] Data Resource は RFC 4627 JSONオブジェクトでなければなりません。 >>1 CKAN でも資源は JSONオブジェクトです。
attr_strfiware-ngsi 関係と思われます。auth_typeoauth2
が指定されていることがあります。
fiware-ngsi 関係と思われます。cache_last_updatenull が指定されていることがあります。cache_urlnull が指定されていることがあります。bytessize が使われます。createddatapath と選択的な必須とされています。 >>1
CKAN API での利用は未見です。:data_crs
GKAN
で空文字列のことがあります。datastore_active1 が指定されていることがあります。descriptionencodingmediatype
との相互作用などは不明です。
CKAN API では空文字列のこと,
utf-8 (mimetype = text/csv)
のことがあります。entityfiware-ngsi 関係と思われます。expressionfiware-ngsi 関係と思われます。formatcsv, xls, json が例示されています。 >>1
CKAN API では空文字列,
CSV,
GeoJSON,
HTML
のような値が使われています (>>10)。
format が空文字列かつ
mimetype
が null
のこともあります。hashsha1: の後に十六進数列を続けた、SHA-1 ハッシュ値と思われるものが示されています。
>>1
CKAN API では空文字列が指定されていることがあります。idlast_modifiednull
や地方日時文字列のことがあります。
created より秒の小数部単位で微妙に古いことがあります。licensesmediatypemetadata_modifiedmetadata_typemimetypenull や
MIME型が指定されていることがあります。
かわりに format に文字列が指定されていることも、
両方が指定されていることもあります。
(>>10)mimetype_innernull が指定されていることがあります。nameopenspending_hint"None" が指定されていることがあります。package_idid が指定されていることがあります。pathdata と選択的な必須とされ、
url-or-path
またはその配列を指定することになっています。 >>1
CKAN API での利用は未見です。payloadfiware-ngsi 関係と思われます。positionresources
配列における索引 (0はじまり) の整数が指定されていることがあります。profileresource_group_id"None" が指定されていることがあります。resource_private_flag0
が指定されていることがあります。resource_typenull,
文字列 image/jpeg
が指定されていることがあります。revision_idid とは違う値です。schemaservice_pathfiware-ngsi 関係と思われます。sizenull
のこともあります。state"active" が指定されていることがあります。sourcestenantfiware-ngsi 関係と思われます。titlename がこれに相当する意味で使われています。urldata:) が入っています。url_typenull が指定されていることがあります。
文字列
upload (url が CKAN システム管理のファイルであることを表す?)
のことがあります。webstore_last_updated"None" や null が指定されていることがあります。webstore_url"None" や null が指定されていることがあります。[11]
size が null で実際にはギガバイト級で、
説明文に人間向けにはそのことが書いてあるみたいな厄介なケースが...
[12] >>11 どうやら CKAN にアップロードされたファイル (url_type = upload)
だと自動で size が付き、外部の URL を登録した場合にはそれがつかないらしい。
[32] >>31 は URL もその他の情報もない謎の空の資源が含まれる事例。 「名無しのリソース」は CKAN が補った題名で API のデータには入っていない。
[53]
>>52 や同じサイトの他のパッケージは資源の
description
が定型化していて (機械的に生成されたものが登録されているのでしょう)、
末尾に
「: ファイルサイズは 4.85 MB です。」
のようにファイルサイズが入っています。
size は null なのですが...
[22] 大抵は HTTP(S) URL が指定されています。
[27] CKAN 本体、 CKAN API と同じ起源の URL のこともあれば、 そうでないこともあります。
[28] 例えば本サイトと CKAN サイトが別にあって本サイトの URL が指定されていることや、ファイル配布用サーバーが別にあってその URL が指定されていることがあります。
[29] また、他の CKAN サイトから複製した CKANパッケージを配布しているようなサイトだと、 まったく異なる起源のこともあります。
[23]
非保安輸送路 (http:) が指定されることもしばしばあります。
CKAN サイトもリンク先の URL も、
未だに非保安輸送路でしか接続されないことがしばしばあります。
[20] URL にアクセスするとHTTPリダイレクトが返される場合があります。
[25]
http: URL が入っていて、アクセスすると https:
URL にリダイレクトされることがしばしばあります。
[19] 素片識別子付きの絶対URLが入っていることがあり、 HTML ファイルの一部分を資源とみなしているようです。 そのようなCKANパッケージには、 素片識別子以外が同じで素片識別子だけが違う URL が指定されたCKAN資源がいくつか入っている場合があるようです。
[26]
稀に data: URL が入っていることがあります。
[24] 空文字列になることがあり、ダウンロード可能なファイルがないことを表しているようです。
[21]
GKAN では format が XYZ
のとき、
url に絶対URLに {x}, {y}, {z}
が入ったURL雛形のことがあります。
>>50
[54]
GKAN では format が WMS
のとき、
url が ? で終わる (URL query が空文字列の)
URL のことがあります。
>>50
URL query を付けることで WMS の HTTP(S) URL として使えるもので、
そのままアクセスしてもエラーになるだけです。
[35] FIWARE-NGSI API 情報が入っているケースがあります。 >>34
[36]
format が fiware-ngsi
となる他に、いくつか関連情報が入っています。
url は絶対URLですが、それだけで GET
アクセスしても意味がありません。
[57] >>55 >>56 これは一例で、このサイトの他のパッケージも同じですが、
HTML では
https://city.himeji.gkan.jp/gkan/dataset/f56d226f-eaaf-4c03-835a-35ccf8d6a12a/resource/a9dfbd33-27a3-41a0-9b4d-8f1d2000bec5/download/282014_himetyari.geojson
のような
URL にリンクしており、
CKAN API
では
https://city.himeji.gkan.jp/admin/gkan/dataset/f56d226f-eaaf-4c03-835a-35ccf8d6a12a/resource/a9dfbd33-27a3-41a0-9b4d-8f1d2000bec5/download/282014_himetyari.geojson
のような
URL にリンクしています。
API の方は /admin が余分に入っています。
アクセスすると 401
エラーになります。
/admin を削れば正常にアクセスできます。
[10] ファイル形式の指定例
application/postscriptapplication/postscriptapplication/postscript.ai。application/illustratorapplication/postscriptapplication/octet-stream.ai が入った ZIPファイルBVFapplication/zipapplication/zipBVF というのは適切ではないが...application/bvf+zipdBaseapplication/vnd.dbfapplication/vnd.dbf
はその意味。
DBF ファイルの実態は
dBASE 形式のデータベースファイル。
dBase と呼ぶのは誤ってはいないが最適でもない。application/vnd.oma.drm.messageapplication/vnd.oma.drm.messageapplication/vnd.oma.drm.messageapplication/vnd.oma.drm.message
は拡張子衝突の別形式
(CKAN で使われるとは考えられず、読み替えるべき)。application/dmdmapplication/octet-streamapplication/dmXLSXXLSXapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetxlsx 全角 application/vnd.openxmlformats-officedocument.spreadsheetml.sheetapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetXLSXapplication/vnd.ms-excelapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetXLSXapplication/zipapplication/zipXLSX が正しい
(xlsx の実態はZIP)application/vnd.openxmlformats-officedocument.spreadsheetml.sheetXLSX( 全角 Shift-JIS) 全角 application/zipapplication/zipGeoTiffapplication/zipapplication/zipGeoTiffimage/jpegimage/jpeggmlapplication/zipapplication/ziptext/html; charset=UTF-8LINKtext/html; charset=UTF-8JPEGimage/jpegJSON( 全角 UTF-8) 全角 application/zipapplication/zipKMLapplication/zipapplication/zipapplication/vnd.google-earth.kmzKMZapplication/vnd.google-earth.kmzmp3audio/mpegODS( 全角 Shift-JIS) 全角 application/zipapplication/zipXMLapplication/xmlapplication/rdf+xmlPPTXapplication/vnd.openxmlformats-officedocument.presentationml.presentationapplication/octet-streamSHPapplication/zipapplication/zipSHPapplication/octet-streamTXTtext/plaintext/plainJSONname 末尾が「application/jsonapplication/json; charset=utf-8DOCXapplication/vnd.openxmlformats-officedocument.wordprocessingml.documentapplication/vnd.openxmlformats-officedocument.wordprocessingml.documentDOCXapplication/vnd.openxmlformats-officedocument.wordprocessingml.documentapplication/octet-streamXBRL( 全角 UTF-8) 全角 binary/octet-streamapplication/zipXML( 全角 UTF-8) 全角 application/octet-streamXML( 全角 UTF-8) 全角 application/zipapplication/zipapplication/octet-stream.mcworld (Minecraft データファイル)text/markdowntext/markdownurl が data: で
description と同文[14] MIME型というものはインターネットメールでも Web でもあまりまともに使われていないのですけど、 CKAN でもかなり酷いですね...
[15]
format と mimetype と url の HTTP
Content-Type
と、3つもあって、しかもそのどれが信じられるともいえないところがまた...
[13] url_type が upload だからといって
mimetype と HTTP Content-Type が一致するとは限らないらしい。
[16]
format に全角英字が入っているところは手入力してるの???
[17]
ZIP の場合、多くは format も ZIP にしているが、
たまに中身のファイル形式を書いていることもある。
ややこしいのは便宜上 ZIP 圧縮しているだけでなく、業界慣習的に
ZIP に入れて配布する事実上の標準が成立しているファイル形式もあるっぽいところで。
その場合確かに ZIP と書くよりファイル形式を書いてくれた方が嬉しい、
ただし中身のファイル形式ではなく「中身+ZIP」と書く方が正確なのだろうけど、
そんな書き方は誰もしていなくて...