ukpolice
Nim wrapper for the UK Police Data API
Wraps a native library — check OS Compatibility below for platform-specific linking notes.
Summary
| Latest Version | 0.1.0 |
|---|---|
| License | MIT |
| CI Status | Failing |
| Downloads | 0 |
| Last Indexed | 2026-07-21 05:27 |
Tags
Authors
- Nemuel Wainaina
Installation
nimble install ukpolice
choosenim install ukpolice
git clone https://github.com/nemuelw/ukpolice
OS Compatibility
| Platform | Linux | macOS | Windows | FreeBSD | OpenBSD | NetBSD | Android | iOS | WASM | Embedded |
|---|---|---|---|---|---|---|---|---|---|---|
| ukpolice | ✓ | ✓ | ✓ | - | - | - | - | - | - | - |
Dependencies
| Package | Version | Optional |
|---|---|---|
| nim >= | 1.6 | No |
| jsony >= | 1.1.5 | No |
Source
| Repository | https://github.com/nemuelw/ukpolice |
|---|---|
| Homepage | https://github.com/nemuelw/ukpolice |
| Registry Source | nimble_official |
README
ukpolice
Nim wrapper for the UK Police Data API
Installation
- Run this command in your project directory:
nimble install ukpolice
Usage
This library provides complete coverage of the UK Police API and can be used to query all available endpoints.
Import the package
import ukpolice
Get available crime dates
# get_available_crime_dates(): seq[CrimeDate]
let crime_dates: seq[CrimeDate] = get_available_crime_dates()
Get a list of all the forces
# get_forces(): seq[Force]
let forces: seq[Force] = get_forces()
Get details of a particular force
# get_force_details(force_id): ForceDetails
let force: ForceDetails = get_force_details("leicestershire")
Get the list of senior officers for a particular force
# get_senior_officers(force_id): seq[Officer]
let senior_officers: seq[Officer] = get_senior_officers("leicestershire")
Get street-level crime data
By coordinates (lat,lng)
# get_street_crimes_by_coords(lat, lng, date): seq[CrimeRecord]
let crimes: seq[CrimeRecord] = get_street_crimes_by_coords("51", "-1.423", "2024-01")
By polygon (sequence of coordinates)
# get_street_crimes_by_polygon(poly, date): seq[CrimeRecord]
let crimes: seq[CrimeRecord] = get_street_crimes_by_polygon(@[("52", "0.5"), ("52.794", "0.4"),
("52.1", "0.5")], date = "2024-01")
Get street-crime outcomes
By location ID
# get_street_crime_outcomes_by_location_id(location_id, date): seq[CrimeOutcomeRecord]
let outcomes: seq[CrimeOutcomeRecord] = get_street_crime_outcomes_by_location_id("1737432", "2024-01")
By coordinates (lat,lng)
# get_street_crime_outcomes_by_coords(lat, lng, date): seq[CrimeOutcomeRecord]
let outcomes: seq[CrimeOutcomeRecord] = get_street_crime_outcomes_by_coords("51", "-1.423", "2024-01")
By polygon
# get_street_crime_outcomes_by_polygon(poly, date): seq[CrimeOutcomeRecord]
let outcomes: seq[CrimeOutcomeRecord] = get_street_crime_outcomes_by_polygon(
@[("52", "0.5"), ("52.794", "0.4"), ("52.1", "0.5")], date = "2024-01")
Get crimes at a location
By location ID
# get_crimes_by_location_id(location_id, date): seq[CrimeRecord]
let crimes: seq[CrimeRecord] = get_crimes_by_location_id("1738423", "2024-01")
By coordinates
# get_crimes_by_coords(lat, lng, date): seq[CrimeRecord]
let crimes: seq[CrimeRecord] = get_crimes_by_coords("52.629729", "-1.131592", "2024-01")
Get crimes with no location
# get_crimes_with_no_location(force_id, category, date): seq[CrimeRecord]
let crimes: seq[CrimeRecord] = get_crimes_with_no_location("leicestershire", "burglary", "2024-01")
Get a list of all available crime categories
# get_crime_categories(date): seq[CrimeCategory]
let crime_categories: seq[CrimeCategory] = get_crime_categories("2024-01")
Get the last time the crime data was updated
# get_crime_last_updated(): LastUpdated
let last_updated: LastUpdated = get_crime_last_updated()
Get outcomes (case history) for a specific crime
# get_outcomes_for_crime(crime_id): CrimeOutcomes
let crime_id = "e11dade0a92a912d12329b9b2abb856ac9520434ad6845c30f503e9901d140f1"
let crime_outcomes: CrimeOutcomes = get_outcomes_for_crime(crime_id)
Get a list of all neighbourhoods for a force
# get_neighbourhoods_for_force(force_id): seq[Neighbourhood]
let neighbourhoods: seq[Neighbourhood] = get_neighbourhoods_for_force("leicestershire")
Get details for a specific neighbourhood
# get_neighbourhood_details(force_id, neighbourhood_id): NeighbourhoodDetails
let details: NeighbourhoodDetails = get_neighbourhood_details("leicestershire", "NC04")
Get neighbourhood boundary
# get_neighbourhood_boundary(force_id, neighbourhood_id): seq[Coords]
let boundary: seq[Coords] = get_neighbourhood_boundary("leicestershire", "NC04")
Get neighbourhood team
# get_neighbourhood_team(force_id, neighbourhood_id): seq[Coords]
let team: seq[Officer] = get_neighbourhood_team("leicestershire", "NC04")
Get neighbourhood events
# get_neighbourhood_events(force_id, neighbourhood_id): seq[Event]
let events: seq[Event] = get_neighbourhood_events("leicestershire", "NC04")
Get neighbourhood priorities
# get_neighbourhood_priorities(force_id, neighbourhood_id): seq[Priority]
let priorities: seq[Priority] = get_neighbourhood_priorities("leicestershire", "NC04")
Get the policing team for an area
# get_policing_team_for_area(lat, lng): PolicingTeam
let team: PolicingTeam = get_policing_team_for_area("51.500617", "-0.124629")
Get stops and searches in a given area
By coordinates
# get_street_stops_and_searches_by_coords(lat, lng, date): seq[StopAndSearch]
let stops_and_searches: seq[StopAndSearch] = get_street_stops_and_searches_by_coords("52.001",
"-1.001", "2024-01")
By polygon
# get_street_stops_and_searches_by_polygon(poly, date): seq[StopAndSearch]
let stops_and_searches: seq[StopAndSearch] = get_street_stops_and_searches_by_polygon(
@[("52", "0.5"), ("52.794", "0.4"), ("52.1", "0.5")], "2024-01")
Get stops and searches at a given point (location ID)
# get_stops_and_searches_by_location_id(location_id, date)
let stops_and_searches: seq[StopAndSearch] = get_stops_and_searches_by_location_id("1609590", "2024-01")
Get stops and searches with no location
# get_stops_and_searches_with_no_location(force_id, date): seq[StopAndSearch]
let stops_and_searches: seq[StopAndSearch] = get_stops_and_searches_with_no_location(
"leicestershire", "2024-01")
Get stops and searches for a particular force
# get_stops_and_searches_by_force(force_id, date)
let stops_and_searches: seq[StopAndSearch] = get_stops_and_searches_by_force("leicestershire", "2024-01")
Tests
- To run tests, simply run this command:
nimble test -d:ssl
Contributing
Contributions are welcome! Feel free to create an issue or open a pull request.
License
This project is licensed under the terms of the MIT License.
SPDX-License-Identifier: MIT