About Snorql for Japan Searchについて
ジャパンサーチ(JPS)で提供するブラウザ用SPARQLインターフェイス(Snorql for Japan Search)は、Richard CyganaikがD2R用に開発し、kurtjxがGitHubで公開しているSnorqlに、Linked Data Browserの一部機能を移植して拡張したJavaScriptツールです。次のような機能を備えています。
Snorql for Japan Search (JPS) is an extended version of Snorql, which was originally developed by Richard Cyganaik for D2R, and maintained in GitHub by kurtjx. The extensions include some functions from Linked Data Browser.
- JPSで用いる名前空間宣言をあらかじめ備えています(
PREFIX
句の記述不要。追記/上書きしてもOK)。 - 結果表示のURIには、そのURIをSnorqlで
describe
するリンクを設定し、登録名前空間がある場合は短縮名表示します。隣に表示されるアイコンに、URI自身へのリンクを設定します。 - 結果一覧(
SELECT
)表示に便利な機能を追加しています。- 変数名を
image
もしくはthumbnail
とすると、URIの代わりに画像(img要素)を表示します。またこのとき、ギャラリー表示への切り替えスイッチも右上に表示します。 GROUP BY ?x
を用い、SELECT
のリストに?x (count(?uri) as ?count)
があるとき、?x
の値URIのリンクを、その値を条件とするクエリに設定します(例えばGROUP BY ?type
としたとき、集約された?type
の各値から、その値をrdf:type
として持つリソースを検索)。- 変数名に
lat(itude)
およびlong(itude)
があると、地図を準備し、切り替えボタン(⯎ show 🗾)を表示します。
- 変数名を
- JPSアイテムの情報表示(
DESCRIBE
)に最適化しています。DESCRIBE
をVirtuosoのCBDモードで実行するとともにアクセス情報、ソース情報を自動的に対象に加え、アイテム全体の情報を入れ子テーブルで表示します。- 可能な範囲で値のラベルを調べて()内に補足表示します。
- 位置情報がある場合に地図を、画像情報がある場合に画像を表示します。
jps:scourceInfo
はソース情報セクションです。提供元の詳細ページはschema:url
、JPSのページはschema:relatedLink
で示しており、それぞれアイコンからこれらはリンクから直接進むことができます(直接リンクは➹を後置して示します)。
- 参考になりそうなクエリ例をポップアップリスト(表示領域が広い場合はクエリ欄右のリスト)に用意しています。例を編集して必要なクエリを実行できます。
- SPARQL Queryのテキストボックスの下に、EasySPARQLを利用するための簡易検索フォームを備えています。
- Namespaces used in JPS are pre declared (no
PREFIX
clause required for JPS). - URI will have a link to Snorql
describe
, and be displayed as QName when possible. The next icon will have a link to the URI itself. - Query results table (
SELECT
) has several functions:- Values for variable
image
orthumbnail
will show images (img element) instead of URI. Also, a gallery view is available for images. - When
GROUP BY ?x
andSELECT ?x (count(?uri) as ?count)
used, the link of?x
values will be a query to select resources with the value (e.g. ifGROUP BY ?type
requested, set query so thatrdf:type
has each result value of?type
). - If variables
lat(itude)
andlong(itude)
presents, a map is prepared and a switcher (⯎ show 🗾) is appeared on the top right.
- Values for variable
- Optimized to present JPS items
DESCRIBE
:- Uses Virtuoso CBD mode on
DESCRIBE
, also automatically adds#accessInfo
and#sourceInfo
to the target resource, so that entire item information including blank nodes be retrieved. - Adds labels to the resources (English, when possible).
- Displays a map if geo info available, and an image if its info available.
- In
jps:scourceInfo
section, the provider page is indicated byschema:url
, and JPS page is byschema:relatedLink
, whosenext iconlink will bring you to those pages (direct link is indicated by ➹ mark).
- Uses Virtuoso CBD mode on
- Example queries are provided in popup (or right hand side if there is plenty of space) menu.
- Bellow the SPARQL Query textarea, a search form to use EasySPARQL is provided.
フォーマットをJSON、XMLにすると、通常のエンドポイントに転送されます。アプリケーションからの利用(EasySPARQL以外)には、こちらのURIを用いてください。
またレコードのRDF(DESCRIBEの結果)をTurtleなどで得るには、Acceptヘッダにフォーマットを指定するか、レコードURIの末尾に拡張子(Turtle、RDF/XML、JSON-LDはそれぞれttl
、rdf
、json[ld]
)を加えて、URIを直接リクエストしてください。
Request with format json|xml
are redirected to the standard endpoint. Use this standard URI from your application (except EasySPARQL query).
If you need a specific format of RDF (not HTML view), request the record URI with Accept header or URI + extension (ttl
, rdf
, json[ld]
for Turtle, RDF/XML, JSON-LD respectively).