Downloads the district (Kreis) tables of the German Police Crime Statistics (PKS) from a versioned data release, as published by the Bundeskriminalamt or harmonized to one territorial boundary and offence classification. Files are cached and checked against the SHA-256 checksums of the release manifest.
Arguments
- years
Integer vector of reporting years, or
NULL(default) for all years of the release.- offence
Offences to return, or
NULL(default) for all. Each element can be an offence key ("435*00"), a short name in English or German ("residential_burglary","wohnungseinbruch"), a full label ("Wohnungseinbruchdiebstahl") or a part of a label ("einbruch", which selects both burglary keys). An exact key, name or label wins over a part. Capitals, spaces and umlauts do not matter. Seepks_offences()for all keys and names. For the data as published, the published keys that feed the selected keys are returned.- harmonize_to
Target boundary year (Gebietsstand).
"latest"(default) is the boundary of the release, read as released; another year harmonizes the data as published with the crosswalk of the release (forward only, soyearsmust not be later than the target);NULLreturns the data as published.- weights
Weights for districts that were split:
"population"(default) or"area". Ignored forharmonize_to = NULL.- version
Data version such as
"2026.1", or"latest"(default).- source
"release"(default) reads a data release."bka", which will rebuild the spreadsheet years from the original BKA files, is not available yet.- cache
Keep downloaded files in the cache (default
TRUE). WithFALSE, files go to a temporary directory and are removed with the R session.- lang
Language of the offence labels in column
offence_labeland of the messages:"de"or"en".NULL(default) usesoptions(pksR.lang), otherwise the language of the R session. Harmonized data get the label of the harmonized key; data as published keep the published German label, or get the English label of the matching harmonized key.
Value
A tibble with one row per year, district (ags) and offence key.
Columns are described in vignette("pksR"). Attributes:
data_version, retrieved_at, boundary_year, weights and
source_urls.
Deutsch
Lädt die Kreistabellen der Polizeilichen Kriminalstatistik (PKS) aus einer versionierten Datenveröffentlichung, wie vom Bundeskriminalamt veröffentlicht oder auf einen Gebietsstand und eine Straftatenzuordnung harmonisiert. Jede Datei wird gegen die SHA-256-Prüfsumme des Manifests geprüft und im Cache abgelegt.
years: Berichtsjahre,NULLfür alle.offence: Straftaten als Schlüssel ("435*00"), Kurzname auf Deutsch oder Englisch ("wohnungseinbruch","residential_burglary"), vollständige Bezeichnung oder Teil einer Bezeichnung ("einbruch"). Groß- und Kleinschreibung, Leerzeichen und Umlaute spielen keine Rolle; eine genaue Übereinstimmung hat Vorrang. Übersicht:pks_offences().harmonize_to:"latest"(Gebietsstand der Veröffentlichung), ein Jahr (Harmonisierung nur vorwärts) oderNULL(wie veröffentlicht).weights: Gewichtung geteilter Kreise,"population"oder"area".version: Datenversion, etwa"2026.1", oder"latest".lang: Sprache der Bezeichnungen und Meldungen,"de"oder"en"; Voreinstellungoptions(pksR.lang), sonst die Sprache der R-Sitzung.
Ergebnis: ein Tibble mit einer Zeile je Jahr, Kreis und Straftatenschlüssel
und den Attributen data_version, retrieved_at, boundary_year, weights
und source_urls.
See also
Other data:
pks_example()
Examples
if (FALSE) { # interactive()
# Total offences, harmonized to the latest boundary
total <- pks_get(offence = "total")
# Theft in total and both burglary keys, German labels
theft <- pks_get(offence = c("diebstahl", "einbruch"), lang = "de")
# As published by the BKA, two years
published <- pks_get(years = 2024:2025, harmonize_to = NULL)
}