Overview

Emergency Services is a hosted proposition that allows Police Forces to quickly match and append name and address data to locate individuals at the correct address quickly and easily. The proposition offers intuitive searching and dynamic autocomplete suggestions to elevate Police's capabilities for tracing individuals.

All searching is performed against Ordnance Survey AddressBase Premium and Electoral Roll data.

Highlights

  • Flexible input options by address, name, UPRN and what3words enhance search conversion rates.
  • Real-time autocomplete search maximizes employee efficiency reducing data entry time by 80% and eliminating human errors.
  • Enriched data and comprehensive address validation increase precision of results to reach the required individuals and properties quickly and efficiently.
  • REST API integration ensures effortless deployment.
  • Provided as a SaaS solution, the service guarantees continual product updates.

Integration

  1. Pass an address in combination with a name to the /address/search/v1/ endpoint.
    Our Emergency Services proposition supports Autocomplete search type only.

    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],        
        "components": {
            "unspecified": [
                "1 main st"
            ],
            "names": [
                {
                    "forename": "John",
                    "middlename": "",
                    "surname": "Dow"
                }
            ]
        }
    }
    
  2. When both an address and a name are provided, the software prioritizes results that match the specified name. The results are filtered to show only addresses associated with the specified name. If multiple people have similar names, all matching results are returned.

        { 
            "global_address_key": "...", 
            "text": "1 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John James Dow"], 
            "uprn": "100070524211" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "10 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Harow Dow"], 
            "uprn": "100070480088" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "10 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Jessie Elizabeth Dow"], 
            "uprn": "100070480088" 
        }
    
  1. Pass an address without specifying a name to the /address/search/v1/ endpoint.

    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],        
        "components": {
            "unspecified": [
                "1 main st"
            ]
        }
    }
    
    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],        
        "components": {
            "unspecified": [
                "1 main st"
            ],
            "names": []
        }
    }
    
  2. When only an address is provided, the software returns all relevant addresses that fully or partially match the input.

        { 
            "global_address_key": "...", 
            "text": "1 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John James Dow"], 
            "uprn": "100070524211" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1 Main Street, Plains, Airdrie, FK10 2NX",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Linda Marie Williams"], 
            "uprn": "100070480088" 
        },
        { 
            "global_address_key": "...", 
            "text": "10 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Michael Philip Henderson"], 
            "uprn": "100070480088" 
        }
    
  1. Pass only a name without an address specified to the /address/search/v1/ endpoint.

    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],        
        "components": {
            "names": [
                {
                    "forename": "John",
                    "middlename": "",
                    "surname": "Dow"
                }
            ]
        }
    }
    
  2. When only a name is provided, the software returns all addresses linked to individuals with the specified name. The response may include multiple addresses if the name is associated with different locations.

        { 
            "global_address_key": "...", 
            "text": "1 Main Street, St. Bees, CA27 0DG",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John James Dow"], 
            "uprn": "100070524211" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "38 Great Ancoats Street, Manchester, M4 5AB",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Harow Dow"], 
            "uprn": "100070480088" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "6 Gadie Crescent, Aberdeen, AB41 7LJ",
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Michael Dow"], 
            "uprn": "100070590087" 
        }
    
  1. Pass a UPRN to the /address/search/v1/ endpoint.

    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],
        "max_suggestions": 10,
        "components": {
            "unspecified": [
                "1234"
            ],
            "names": [
                {
                    "forename": "John",
                    "middlename": "",
                    "surname": "Dow"
                }
            ]
        }
    }
    
    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],
        "max_suggestions": 10,
        "components": {
            "unspecified": [
                "01234"
            ],
            "names": [
                {
                    "forename": "John",
                    "middlename": "",
                    "surname": "Dow"
                }
            ]
        }
    }
    
  2. If a UPRN is detected in the input, it is prioritized in the search results. If no UPRN is detected, the software will perform a standard address search based on available input fields, such as premise number, street name, or postcode.

    UPRN without leading zero
    If the input is a numeric string without leading zero (e.g., "1234"), the software will first return an exact UPRN match (if one exists) and then include addresses where the premise number matches the input.
    Each result includes an UPRN field to indicate whether the match is based on UPRN or premise number.

        { 
            "global_address_key": "...", 
            "text": "39 Slymbridge Avenue, Bristol, BS10 7JQ", 
            "matched": [], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Dow"], 
            "uprn": "1234" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1234 Pershore Road, Stirchley, Birmingham, B30 2YA", 
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Oliver Bennett"], 
            "uprn": "100070480088" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1234 Pershore Road, Stirchley, Birmingham, B30 2YA", 
            "matched": [...], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Emma Caldwell"], 
            "uprn": "100070480088" 
        }
    

    UPRN with leading zero
    If the input contains leading zero (e.g., "01234"), the software will only return exact UPRN matches and will not include addresses based on a matching premise number.

        { 
            "global_address_key": "...", 
            "text": "39 Slymbridge Avenue, Bristol, BS10 7JQ", 
            "matched": [], 
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Dow"], 
            "uprn": "1234" 
        }
    

    Tips

    • If you search for a UPRN and do not want premise number matches, add leading zero if applicable.
    • If you want to retrieve both UPRN and premise number matches, use the numeric input without leading zero.
  1. Pass a what3words address either independently or in combination with a name to the /address/search/v1/ endpoint.

    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],
        "max_suggestions": 10,
        "components": {
            "unspecified": [
                "///crowd.lower.weds"
            ]
        }
    }
    
    POST /address/search/v1 HTTP/1.1
    
    {
        "country_iso": "GBR",
        "datasets": [
            "gb-address-addressbasenames"
        ],
        "max_suggestions": 10,
        "components": {
            "unspecified": [
                "///crowd.lower.weds"
            ],
            "names": [
                {
                    "forename": "John",
                    "middlename": "",
                    "surname": "Dow"
                }
            ]
        }
    }
    
  2. If the input contains only a what3words address (e.g., "///crowd.lower.weds"), the software will return a list of addresses that match the given W3W location.

        { 
            "global_address_key": "...", 
            "text": "65 High Street, Oxford, OX1 4BA",
            "format": "...", 
            "dataset": "Addressbasenames",
            "uprn": "100070524211" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1 Rose Lane, Oxford, OX1 4DT",
            "format": "...", 
            "dataset": "Addressbasenames",
            "uprn": "100070480088" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1 Rose Lane, Oxford, OX1 4DT",
            "format": "...", 
            "dataset": "Addressbasenames",
            "uprn": "100070480088" 
        }
    

    Searching by W3W and name
    If the input includes both a what3words address and a name, the software will prioritize addresses associated with the specified name first, followed by additional results from the W3W search.

        { 
            "global_address_key": "...", 
            "text": "65 High Street, Oxford, OX1 4BA",
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["John Dow"], 
            "uprn": "100070524211" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1 Rose Lane, Oxford, OX1 4DT",
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Oliver Bennett"], 
            "uprn": "100070480088" 
        }, 
        { 
            "global_address_key": "...", 
            "text": "1 Rose Lane, Oxford, OX1 4DT",
            "format": "...", 
            "dataset": "Addressbasenames", 
            "names": ["Emma Caldwell"], 
            "uprn": "100070480088" 
        }