uk-police 0.1.0

A Python wrapper for the UK Police API.

Pyolice

Overview

Pyolice is a Python wrapper for the UK Police API, providing an easy-to-use interface to access and interact with police data such as street-level crimes, outcomes, neighbourhoods, and stop-and-search activities. This readme.md is generated through ChatGPT for now, please forgive errors.

Features

• Retrieve street-level crimes at specific locations or within custom areas.
• Fetch crime outcomes by coordinates, location, or area.
• Access information about neighbourhoods, including teams, events, and boundaries.
• Perform stop-and-search queries by area, force, or location.
• List and get details of police forces.
• Obtain metadata, such as available crime categories and the last updated date for the data.

Requirements

• Python 3.7 or later
• requests

Usage

Pyolice is split between 4 sections

• Street level crimes
• Neighbourhood
• Stop and search
• Police force

this is an example to find specific info:

import pyolice

# Step 1: Locate the neighbourhood for specific coordinates
neighbourhood_info = pyolice.neighbourhoods.locate_neighbourhood(latitude=52.629729, longitude=-1.131592)
force_id = neighbourhood_info['force']
neighbourhood_id = neighbourhood_info['neighbourhood']

# Step 2: Get detailed information about the neighbourhood
neighbourhood_details = pyolice.neighbourhoods.get_neighbourhood_details(force_id=force_id, neighbourhood_id=neighbourhood_id)
print("Neighbourhood Details:", neighbourhood_details)

# Step 3: Fetch street-level crimes in the neighbourhood area
polygon = "52.268,0.543:52.794,0.238:52.130,0.478"  # Replace with actual boundary data if available
crimes = pyolice.street_level.get_street_crimes_in_area(poly=polygon, date="2023-12")
print("Crimes in Area:", crimes)

# Step 4: Retrieve outcomes for crimes near the specified coordinates
outcomes = pyolice.street_level.get_outcomes_by_coordinates(lat=52.629729, lng=-1.131592, date="2023-12")
print("Crime Outcomes:", outcomes)

Methods

Below are all methods in the api

Street Level Crimes

Methods relating to Street Level Crime:

Fetching Crimes at a Specific Location

import pyolice

crimes = pyolice.street_level.get_street_crimes_at_location(lat=52.629729, lng=-1.131592)
print(crimes)

Fetching Crimes in a Custom Area

import pyolice

polygon = "52.268,0.543:52.794,0.238:52.130,0.478"
crimes = pyolice.street_level.get_street_crimes_in_area(poly=polygon)
print(crimes)

Fetching Outcomes at a Specific Location

import pyolice

outcomes = pyolice.street_level.get_outcomes_at_location(location_id="12345", date="2023-12")
print(outcomes)

Fetching Outcomes by Coordinates

import pyolice

outcomes = pyolice.street_level.get_outcomes_by_coordinates(lat=52.629729, lng=-1.131592, date="2023-12")
print(outcomes)

Fetching Outcomes in a Custom Area

import pyolice

polygon = "52.268,0.543:52.794,0.238:52.130,0.478"
outcomes = pyolice.street_level.get_outcomes_in_area(poly=polygon)
print(outcomes)

Fetching Crimes at a Specific Location by ID or Coordinates

import pyolice

# Fetch by location ID
crimes = pyolice.street_level.get_crimes_at_specific_location(location_id="12345")
print(crimes)

# Fetch by coordinates
crimes = pyolice.street_level.get_crimes_at_specific_location(lat=52.629729, lng=-1.131592)
print(crimes)

Fetching Crimes with No Location

import pyolice

crimes = pyolice.street_level.get_crimes_no_location(category="all-crime", force="leicestershire", date="2023-12")
print(crimes)

Fetching Crime Categories

import pyolice

categories = pyolice.street_level.get_crime_categories(date="2023-12")
print(categories)

Fetching Last Updated Date

import pyolice

last_updated = pyolice.street_level.get_last_updated()
print(last_updated)

Fetching Outcomes for a Specific Crime

import pyolice

crime_id = "e11dade0a92a912d12329b9b2abb856ac9520434ad6845c30f503e9901d140f1"
outcomes = pyolice.street_level.get_outcomes_for_crime(crime_id=crime_id)
print(outcomes)

Fetching Neighbourhood Details

Methods relating to neighbourhoods:

Listing Neighbourhoods for a Force

import pyolice

neighbourhoods = pyolice.neighbourhoods.list_neighbourhoods(force_id="leicestershire")
print(neighbourhoods)

Fetching Neighbourhood Details

import pyolice

details = pyolice.neighbourhoods.get_neighbourhood_details(force_id="leicestershire", neighbourhood_id="12345")
print(details)

Fetching Neighbourhood Boundary

import pyolice

boundary = pyolice.neighbourhoods.get_neighbourhood_boundary(force_id="leicestershire", neighbourhood_id="12345")
print(boundary)

Fetching Neighbourhood Team Members

import pyolice

team = pyolice.neighbourhoods.get_neighbourhood_team(force_id="leicestershire", neighbourhood_id="12345")
print(team)

Fetching Neighbourhood Events

import pyolice

events = pyolice.neighbourhoods.get_neighbourhood_events(force_id="leicestershire", neighbourhood_id="12345")
print(events)

Fetching Neighbourhood Priorities

import pyolice

priorities = pyolice.neighbourhoods.get_neighbourhood_priorities(force_id="leicestershire", neighbourhood_id="12345")
print(priorities)

Locating Neighbourhood by Coordinates

import pyolice

location = pyolice.neighbourhoods.locate_neighbourhood(latitude=52.629729, longitude=-1.131592)
print(location)

Stop and Search

Methods relating to stop and search:

Stop and Search by Area

import pyolice

# By latitude and longitude
stops = pyolice.stop_search.stop_and_search_by_area(lat=52.629729, lng=-1.131592, date="2023-12")
print(stops)

# By polygon
polygon = "52.268,0.543:52.794,0.238:52.130,0.478"
stops = pyolice.stop_search.stop_and_search_by_area(poly=polygon, date="2023-12")
print(stops)

Stop and Search by Location

import pyolice

stops = pyolice.stop_search.stop_and_search_by_location(location_id="12345", date="2023-12")
print(stops)

Stop and Search with No Location

import pyolice

stops = pyolice.stop_search.stop_and_search_no_location(force="leicestershire", date="2023-12")
print(stops)

Stop and Search by Force

import pyolice

stops = pyolice.stop_search.stop_and_search_by_force(force="leicestershire", date="2023-12")
print(stops)

Fetching Police Force Details

Methods relating to Forces:

Listing All Police Forces

import pyolice

forces = pyolice.forces.list_forces()
print(forces)

Fetching Details of a Specific Police Force

import pyolice

details = pyolice.forces.get_force_details(force_id="leicestershire")
print(details)

Fetching Senior Officers of a Specific Police Force

import pyolice

officers = pyolice.forces.get_senior_officers(force_id="leicestershire")
print(officers)

Validation

Pyolice provides built-in validation for inputs:

• Latitude and longitude are validated to ensure they fall within valid ranges.
• Polygon strings for custom areas are checked for proper formatting.

Acknowledgements

This project relies on the UK Police API for data access and services.