Package 'WikidataQueryServiceR'

Get an example SPARQL query from Wikidata

Description

Gets the specified example(s) from SPARQL query service examples page using Wikidata's MediaWiki API.

Usage

get_example(example_name)

Arguments

example_name

the names of the examples as they appear on this page

Details

If you are planning on extracting multiple examples, please provide all the names as a single vector for efficiency.

Value

The SPARQL query as a character vector.

See Also

query_wikidata

Examples

## Not run: 
sparql_query <- extract_example(c("Cats", "Horses"))
query_wikidata(sparql_query)
# returns a named list with two data frames
# one called "Cats" and one called "Horses"

sparql_query <- extract_example("Largest cities with female mayor")
cat(sparql_query)
query_wikidata(sparql_query)

## End(Not run)

---

Send one or more SPARQL queries to WDQS

Description

Makes a POST request to Wikidata Query Service SPARQL endpoint.

Usage

query_wikidata(sparql_query, format = c("simple", "smart"))

Arguments

sparql_query	SPARQL query (can be a vector of queries)
format	"simple" uses CSV and returns pure character data frame, while "smart" fetches JSON-formatted data and returns a data frame with datetime columns converted to POSIXct

Value

A tibble data frame

Query limits

There is a hard query deadline configured which is set to 60 seconds. There are also following limits:

• One client (user agent + IP) is allowed 60 seconds of processing time each 60 seconds

• One client is allowed 30 error queries per minute See query limits section in the WDQS user manual for more information.

See Also

get_example

Examples

sparql_query <- "SELECT
  ?softwareVersion ?publicationDate
WHERE {
  BIND(wd:Q206904 AS ?R)
  ?R p:P348 [
    ps:P348 ?softwareVersion;
    pq:P577 ?publicationDate
  ] .
}"
query_wikidata(sparql_query)

## Not run: 
query_wikidata(sparql_query, format = "smart")

## End(Not run)

---

Deprecated functions

Description

Why did I have to go and make things so deprecated?

Usage

scrape_example(example_name, ...)

Arguments

example_name	the names of the examples as they appear on this page
...	ignored (kept for backwards-compatibility)

Functions

• scrape_example: use get_example instead which employs WikipediR::page_content

---