Crime library

Introduction

Package to make Crime data requests, this API lets you retrieve crime information from 30+ cities across the US and LATAM. The API exposes four methods to retrieve raw crime date, crime statistics, crime coverage information, and crowdsourced crime data.

It's implementing the methods from the following known Crime data API provider crimeometer.com.

It has a FREE API key for testing purposes that can be found in the previous link. Contact the API provider to get more information about unlimited requests and their prices.

Installation

dependencies:
  crime: 0.1.2

Example

See example/main.dart

import 'package:crime/crime.dart';

void main() async {
  try {
    const String API_KEY = "XXXXXXXXXXXXXXX"; // Your private API Key.

    final Crime crime = Crime(apiKey: API_KEY);

    final CrimeRawIncidents crimeIncidents = await crime.getCrimeIncidents(
      37.773972,
      -122.431297,
      "50mi",
      DateTime(2021, 1, 1),
      DateTime(2021, 2, 7),
    );

    crimeIncidents.incidents?.forEach((CrimeRawData crimeData) {
      print(
          "Crime incident [${crimeData.incidentOffense}] at [${crimeData.cityKey}]");
    });
  } catch (e) {
    print(e);
  }
}

Methods

Constructor

Library crime class constructor, includes a mandatory parameter to set the apiKey.

Crime({this.apiKey});

getCrimeCoverageData

Method to fetch crime coverage data from the cities of the U.S, and a few cities in LATAM: Sao Paulo (Brazil), Rio de Janeiro (Brazil), Buenos Aires (Argentina), Santiago (Chile), Montevideo (Uruguay), León (Mexico) and others.

Future<List<CrimeCoverage>> getCrimeCoverageData();

getCrimeIncidents

A method to obtain crime incident data from a specific location, over a range of distance, and over a period of time.

Future<CrimeRawIncidents> getCrimeIncidents(double latitude, double longitude, String distance, DateTime startDateTime, DateTime endDateTime, {int page = 1});

getCrimeStats

Method to fetch crime statistics from a specific location, over a range of distance, and over a period of time.

Future<CrimeStats> getCrimeStats(double latitude, double longitude, String distance, DateTime startDateTime, DateTime endDateTime, {int source = 1});

getCrowdsourcedCrimeIncidents

A method to obtain unofficial crime incident data from a specific location, over a range of distance, and over a period of time. This information is collected from the community through CityCop app.

Future<CrimeCrowdIncidents> getCrowdsourcedCrimeIncidents(double latitude, double longitude, String distance, DateTime startDateTime, DateTime endDateTime, {int page = 1});

Responses

CrimeCoverage

Attribute	Type	Description
cityName	String	The name of the city.
incidentsQuantity	int	The amount of incidents.
cityKey	String	The key value of the city.
firstIncidentDate	DateTime	The date of the first incident.
lastIncidentDate	DateTime	The date of the last incident.

CrimeRawIncidents

Attribute	Type	Description
totalIncidents	int	Total number of incidents.
totalPages	int	Total number of pages for the request.
incidents	List<CrimeRawData>	List of incidents.

CrimeRawData

Attribute	Type	Description
cityKey	String	City code in UN/LOCODE standard.
incidentCode	String	Incident code provided by the source.
incidentDate	DateTime	Incident occurred date (aprox.).
incidentOffense	String	Incident offense type using FBI-NIBRS standard.
incidentOffenseCode	String	Incident offense code using FBI-NIBRS standard.
incidentOffenseDescription	String	Incident offense sub type using FBI-NIBRS standard.
incidentOffenseDetailDescription	String	Incident detail description.
incidentOffenseCrimeAgainst	String	Incident against Person/Property/Society/Not a Crime.
incidentOffenseAction	String	Incident action status (Commited/Attempted).
incidentSourceOriginalType	String	Type of incident from the original source.
incidentSourceName	String	Incident source name.
incidentLatitude	double	Incident latitude.
incidentLongitude	double	Incident longitude.
incidentAddress	String	Incident address (approximate in some cases).

CrimeCrowdIncidents

Attribute	Type	Description
totalIncidents	int	Total number of incidents.
totalPages	int	Total number of pages for the request.
incidents	List<CrimeRawCrowdData>	List of incidents.

CrimeRawCrowdData

Attribute	Type	Description
incidentCode	String	Incident code provided by the source.
incidentLatitude	double	Incident latitude.
incidentLongitude	double	Incident longitude.

CrimeStats

Attribute	Type	Description
totalIncidents	int	Total number of incidents.
reportTypes	List<CrimeReportType>	List of incidents offenses.

CrimeReportType

Attribute	Type	Description
type	String	Incident offense description.
count	int	Total number of incidents by offense description.

Exceptions

• MandatoryApiKeyException: missing mandatory API Key.
• ForbiddenRequestException: Forbidden resource, API Key has been deactivated.
• LimitExceededRequestException: Too many requests in a short time.

Dependencies

http: ^0.13.1
intl: ^0.17.0

License

BSD 3-Clause License