Wikidane:Obsługa zapytań SPARQL/Pomoc zapytań Wikidanych/Widoki wyników
Shortcut: wd:WDQS/Result views




Ta strona opisuje interfejs WDQS i pomoże ci zrozumieć różne możliwości wyświetlania wyników obsługi kwerend SPARQL. Strona z przykładami kwerend zawiera wiele dobrych przykładów, z których możesz skorzystać!
Otwórz interfejs WDQS a następnie:
- wybierz swój język pod
w górnym pasku narzędzi.
- wpisz poprawny kod SPARQL w obszarze tekstu.
- sprawdź swój kod, najeżdżając myszą na elementy; pojawi się dymek, którego treść powinna być zgodna z tym, co chcesz osiągnąć. Wykorzystuje wybrany przez Ciebie język (domyślnie przechodzi na angielski).
- then click on blue button Execute query of the sidebar to launch the request. Red square is lit in the sidebar while the command executes.
- after running a query, you can choose in the "Display" formats which result view you want to display. Depending on your query and the data type, some of the views will not be available.
Przykład kodu |
---|
# Recent events
SELECT ?event ?eventLabel ?date
WHERE
{
# find events
?event wdt:P31/wdt:P279* wd:Q1190554.
# with a point in time or start date
OPTIONAL { ?event wdt:P585 ?date. }
OPTIONAL { ?event wdt:P580 ?date. }
# but at least one of those
FILTER(BOUND(?date) && DATATYPE(?date) = xsd:dateTime).
# not in the future, and not more than 31 days ago
BIND(NOW() - ?date AS ?distance).
FILTER(0 <= ?distance && ?distance < 31).
# and get a label as well
OPTIONAL {
?event rdfs:label ?eventLabel.
FILTER(LANG(?eventLabel) = "en").
}
}
# limit to 10 results so we don't timeout
LIMIT 10
|
Note: You can also run directly a hardcoded request via the TryIt links of this page. When it brings you directly to the result display you can always return to the source script unsing the link at the bottom of the interface.
Tabela (domyślny)
Pokazuje dane wynikowe w formie tabeli. To jest domyślny widok wyników i potrafi wyświetlać dane dowolnego typu.
Will map every variable from the SPARQL select clause to a formatted table column.
-
Table Result
-
Table Result on small screens with flipped columns
Image Grid

Shows the result data as a grid with images.
Every grid item has a big picture and opens the gallery when clicking on it.
Contents an item is the formatted row data.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Commons Media | Grid Item | Image columns will create a grid item. |
Rows containing no image will be ignored.
It’s nonetheless possible to include no image rows in the result by modifying the sparql by including a default image in case the image variable is not bound:
optional {
?item wdt:P18 ?img_ .
}
bind (if(bound(?img_),
?img_,
<http://commons.wikimedia.org/wiki/Special:FilePath/File:Profile_avatar_placeholder_large.png>) as ?image) # [[:commons:File:Profile_avatar_placeholder_large.png]] as a placeholder
Here the file commons:File:Profile avatar placeholder large.png is used as a placeholder, you can use your own.
Opcje
Nazwa opcji | Typ | Opis |
---|---|---|
hide
|
One or more variable names (strings, starting with ? ), single value or array
|
Don’t show these variables in the result. |
Mapa
Shows the result data as map with OpenStreetMap data.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Współrzędna | Map Marker | Columns will create a marker on the map.
Content of that marker is the formatted row data. |
?layer | Map Marker Layer | Creates a colored map layer that allows filtering. | |
?rgb | Kolor | Color Map Marker | Example 000000 for black color. |
-
Mapa z warstwami Wypróbuj
-
Technically, any well-known text literal can be displayed, not just a point coordinate.
Non-point geometry values are never stored on Wikidata, but they can be constructed in SPARQL using functions like CONCAT()
and STRDT()
–
see this map of Czech railway lines for an example of LINESTRING()
geometry.
Opcje
specify using e.g. #defaultView:Map{"hide":["?foo", "?bar"],"layer":"?bar"}
, using an array when there are multiple variables.
Nazwa opcji | Typ | Opis |
---|---|---|
hide
|
One or more variable names (strings, starting with ? ), single value or array
|
Don’t show these variables in the result. |
layer
|
One or more variable names (strings, starting with ? ), single value or array
|
Use these variables for the map layer, instead of the default ?layerLabel , ?layer .
|
markercluster
|
boolean or object |
|
Line, Bar, Scatter and Area Chart
Shows one of these chart types.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Liczba
Etykieta DateTime |
Oś x
Oś y |
First will be X-axis, second Y-axis |
* | Etykieta | Category / Legend Item (optional) | Will only be used after the above are mapped |
* | Etykieta | Storyboard / Animation (optional) | Will only be used after the above are mapped |
Wykres bąbelkowy

Shows a bubble chart where the size and the color of the bubble can configured.
When an item is provided a bubble is linked to Wikidata.org.
Zmienna | Typ danych | Mapowanie |
---|---|---|
* | Etykieta | Bubble Label |
* | Liczba | Bubble Size |
* | Element | Bubble Link (optional) |
?rgb | Kolor | Bubble Color (optional) |
Tree Map

Shows a zoomable tree map.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Etykieta | Etykieta | 1st label in a row will be 1st level in tree map. 2nd label will be 2nd level. 3rd label will be 3rd level etc.. |
* | Element | Link (optional) | |
* | Quantity | Size |
Drzewo
Shows an expandable tree.

Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Element | Node ID | First item will be a root node the following items in the same row will be nested. |
* | Etykieta | Node Label (optional) | Labels will be appended to current node. |
* | Liczba | Node Label (optional) | |
* | Commons Media | Item image |
Oś czasu

Shows a explorable timeline.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | DateTime | Item Point in Time
Item End Point in Time |
First date in a row sets the item position in the timeline.
If a second date is present a start and end date will be set. |
* | Commons Media | Item image |
Opcje
Nazwa opcji | Typ | Opis |
---|---|---|
hide
|
One or more variable names (strings, starting with ? ), single value or array
|
Don’t show these variables in the result. |
Dimensions

Shows dimension and their links.
It also allows filtering them by selecting an axis fraction.
This type of graph is also known as parallel coordinates.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Etykieta | Dimension | Every column in the result row is mapped to a dimension |
* | Liczba | ||
* | DateTime |
Wykres
Shows an interactive graph that allow hierarchically ordering and exploring items.
Zmienna | Typ danych | Mapowanie | Opis |
---|---|---|---|
* | Element | Node ID | First item in a row of output variables will have an arrow pointing to the items in the same row. |
* | Etykieta | Node Label (optional) | |
* | Commons Media | Node Image (optional) | |
?rgb | Kolor | Node Color (optional) | Color of the item just before the rgb variable. Example 000000 for black color. |
* | Liczba | Node Size (optional) | |
?edgeLabel | Etykieta | Edge Label (optional) |
-
Wykres
-
Dodatkowe informacje
RDF Data Type Mapping
RDF Type | RDF Data Type | Constraint | Data Type |
---|---|---|---|
URI | String starts with http://www.wikidata.org/entity/Q |
Entity | |
URI | String starts with http://commons.wikimedia.org/wiki/Special:FilePath |
Commons Media | |
Literal | http://www.w3.org/2001/XMLSchema#dateTime | DateTime | |
Literal | http://www.opengis.net/ont/geosparql#wktLiteral | Coordinate | |
Literal | http://www.w3.org/2001/XMLSchema#double
http://www.w3.org/2001/XMLSchema#float http://www.w3.org/2001/XMLSchema#decimal http://www.w3.org/2001/XMLSchema#integer http://www.w3.org/2001/XMLSchema#long http://www.w3.org/2001/XMLSchema#int http://www.w3.org/2001/XMLSchema#short http://www.w3.org/2001/XMLSchema#nonNegativeInteger http://www.w3.org/2001/XMLSchema#positiveInteger http://www.w3.org/2001/XMLSchema#unsignedLong http://www.w3.org/2001/XMLSchema#unsignedInt http://www.w3.org/2001/XMLSchema#unsignedShort http://www.w3.org/2001/XMLSchema#nonPositiveInteger http://www.w3.org/2001/XMLSchema#negativeInteger |
Liczba | |
Literal | Has no RDF Data Type | Etykieta | |
Literal | Has property xml:lang |
Etykieta | |
Literal | String matches /^[0-9A-F]{6}$/ |
Kolor |
Formatowanie
There is special formatting for the following data types:
Typ danych | Format |
---|---|
Entity | Link to Wikidata.org
Label is shortened to wd:Qxx Explore an item (magnify icon) |
DateTime | MM DD, YYYY
Tooltip shows raw ISO timestamp |
Commons Media | Link to Commons.Wikimedia.org
Displaying Gallery ( image icon ) |
Mobile / Responsive
Result views are made to work on different devices and resolutions. Their appearance may change depending on the space they can use.
Embed Mode
Result views can be linked or embedded via iframes. You can get the regarding link or code by clicking Link in the above menu.
Zobacz różnicę: link to a query i link do wyniku or the embed code:
<iframe style="width:80vw; height:50vh;" scrolling="yes" frameborder="0" src="http://tinyurl.com/zwf4k2w">
Download results

There are several ways to export the results of a query.
JSON, TSV and CSV are three different open-standard formats to download the data, offered under the Download tab. To get results in XML format, click on Link > SPARQL endpoint.
You can also download some of the graphic views as a SVG file: this feature works with all the views except table, image grid, timeline, graph builder, map, and graph.
Widok Domyślny
The default view can be change for each SPARQL query by using a comment:
#defaultView:[NAME]
Na przykład:
#defaultView:ImageGrid
Result view options
Result views can be configured with various options, which are specified in JSON (Q2063) format, either following the defaultView
comment (see previous section) or following a separate view
comment.
#defaultView:Map{"layer": "?typeLabel"}
#view:ImageGrid{"hide": "?coords"}
Tytuł
Result views can show a title. The title can be set via a title
comment.
#title:A title of your choice
List of WDQS tags
WDQS tag | Display options | Uwagi |
---|---|---|
#defaultView:Table | Table | default format when omitted |
#defaultView:ImageGrid | Image grid | |
Graph builder | access to the graph builder tool | |
#defaultView:Map | Map | |
#defaultView:LineChart | Line chart | |
#defaultView:BarChart | Bar chart | |
#defaultView:ScatterChart | Scatter chart | |
#defaultView:AreaChart | Area chart | |
#defaultView:BubbleChart | Bubble chart | |
#defaultView:TreeMap | Tree map | |
#defaultView:Tree | Tree | |
#defaultView:Timeline | Timeline | |
#defaultView:Dimensions | Dimensions | |
#defaultView:Graph | Graph | |
#title: | title of the WDQS results frame | |
#view: | equivalent to prefix #defaultView: |
Auto language
When using the magic keyword [AUTO_LANGUAGE]
it is replaced by the users language when submitting the query. This allows writing a query with where the result is displayed in the users language.
Przykład:
#<span lang="en" dir="ltr" class="mw-content-ltr">Use language of the user for display labels and fallback to english as default</span>
SERVICE wikibase:label {
bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en" .
}
Auto coordinates
When using the magic keyword [AUTO_COORDINATES]
it is replaced by the users location when submitting the query (with clients accepting the geolocalization). This allows writing a query with the users' location.
Przykład:
#defaultView:Map
SELECT ?place ?coordinate_location ?dist {
SERVICE wikibase:around {
?place wdt:P625 ?coordinate_location.
bd:serviceParam wikibase:center "[AUTO_COORDINATES]".
bd:serviceParam wikibase:radius "1".
bd:serviceParam wikibase:distance ?dist.
}
}