0151 355 4555



Finds the location of a free-text address element. The location is returned as an array of FuzzyPosition objects, each representing the location of one possible alternative location.

If you have a full postcode for the address, you can retrieve the location more easily using the FindLocation method.

By default, only the Easting, Northing, GridReference, Longitude and Latitude properties of the returned Position objects are populated.

In order to retrieve the data for the CountyCode, County, DistrictCode, District, WardCode and Ward properties, include an Option with the Name GetAdminArea and the Value True.

In order to retrieve the data for the Country property, include an Option with the Name GetCountry and the Value True. The value of the returned Country property will be one of the following values:

  • England
  • Scotland
  • Wales
  • NorthernIreland
  • ChannelIslands
  • IsleOfMan
  • NotSupplied

View all Geocoding (contact us for more information about this service) 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 type="text/javascript">

function loadIntegr8() {
  // Load the Location Integr8 service

function Geocode(licence, name) {
  /// <param name="licence">string. One of the following values: WebServer, WebClick, InternalUser, SmallUser, Lookup, InternalServer</param>
  /// <param name="name">string</param>
  var location = new data8.location();

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
    //   Contains the positions of any locations that match the query.
    //   The position can be extracted from these values in any of three ways:
    //   1. Using the Easting and Northing fields, measured in metres east and north
    //   of the point at 49° N, 2° W.
    //   2. Using the GridReference field to get the standard Ordnance Survey grid reference.
    //   3. Using the Latitude and Longitude fields to get the location according to
    //   the selected datum (defaults to WGS84)
    //   For areas larger than a single postcode, the StdDev field indicates the spread of
    //   addresses within the area.