Wikidane:Obsługa zapytań SPARQL/Pomoc zapytań Wikidanych/Widoki wyników

interfejs WDQS

Po najechaniu na kod SPARQL wyświetla się dymek

WDQS result display selection

Link to show script in WDQS results window after a Try It

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.

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

Image Grid Try Out

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.

See a complete query example using this technique.

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
• 
• File:Map of airports in Belgium

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	If the value is an object, pass these options to Leaflet.markercluster, a map plugin for clustering nearby map markers. (If the value is the empty object {}, Leaflet.markercluster is enabled with its default options.) If the value is true (default for queries without map layers), Leaflet.markercluster is enabled with a special set of options that doesn’t cluster any nearby map markers (it only “spiderfies” markers with exactly identical coordinates) and attempts to replicate the default map look as much as possible. If the value is false (default for queries with map layers), Leaflet.markercluster is not enabled.

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

• 
• File:Line Chart
• 
• File:Area Chart
• File:Bar Chart (Animated)
• 
• File:Scatter Chart (animated)

Wykres bąbelkowy

Wykres bąbelkowy Wypróbuj

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

Tree Map

Try Out

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.

Drzewo Try Out

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

Timeline

Wypróbuj

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

Dimensions

Wypróbuj

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
• File:Graph browsing Abraham Lincoln (animated)

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

Download results buttons

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.
  }
}

Try it!