0151 355 4555

Geocode

Description

Returns a list of possible locations for a UK landline telephone number, sorted with the most likely location first.

Each location in the returned list consists of a postcode sector (everything apart from the last two letters, e.g. CH2 4), the probability that the telephone number lies within this postcode sector as a number from 0 - 100, and a list of postal areas associated with that postcode.

View all Telephone Geocoding (part of the identity validation suite) methods

Code Samples

<!-- Import the Integr8 Ajax API -->
<!-- NOTE: Get your own API key to use in the following script tag from: -->
<!-- http://www.data-8.co.uk/integr8/Admin/Ajax.aspx -->
<script src="https://webservices.data-8.co.uk/Javascript/Loader.ashx?key=your-api-key" type="text/javascript">
</script>

<script type="text/javascript">

function loadIntegr8() {
  // Load the TelephoneGeocoding Integr8 service
  data8.load('TelephoneGeocoding');
}

function Geocode(number) {
  /// <param name="number">string</param>
  var telephonegeocoding = new data8.telephonegeocoding();
  
  telephonegeocoding.geocode(
    number,
    null,
    showGeocodeResult
  );
}

function showGeocodeResult(result) {
  // Check that the call succeeded, and show the error message if there was a problem.
  if (!result.Status.Success) {
    alert('Error: ' + result.Status.ErrorMessage);
  }
  else {
    // TODO: Process method results here.
    // Results can be extracted from the following fields:
    // result.Results
    //   Lists the possible locations of the telephone number.
    // result.Confidence
    //   Indicates the confidence level in the results.
  }
}

loadIntegr8();

</script>