Loqate | A GBG Solution

Premise Level Geocode Fields

GBG's Premise Level Geocode is available to customers who require greater accuracy than Postcode Centroids, and can be used in conjunction with other UK Address Datasets i.e. PAF (Postal Address File).

Requestable Fields

The various data that is provided by this dataset can be excluded from being returned, for each address by providing one or more values in the IdmRequestOption.relatedDataItems property of the IDM request.

For each value provided, the corresponding data is returned, and the corresponding data for all the values not provided are not returned.

The following values are supported by this dataset:

Key Mnemonic	Description	Returned By Default
LICOUNTRY	Country	Yes
LIEASTING	Easting	Yes
LINORTHING	Northing	Yes
LIGEOACC	Geocode accuracy code	Yes
LIGEOACCD	Geocode accuracy description	Yes
LILAT	Latitude	Yes
LILONG	Longitude	Yes

Output Format

The Premise Level Geocode data is returned in the groupedAdditionalItems section of the IdmDataAddress.

For this dataset, the group name used is "PremiseLevelGeocode" and the key/value pairs are as follows:

Field Name	Description
LICOUNTRY	Country
LIEASTING	Easting
LINORTHING	Northing
LILAT	Latitude
LILONG	Longitude
LIGEOACC	Accuracy Code (see accuracy code lookup table for details)
LIGEOACCD	Accuracy Description (corresponds to the description in the accuracy code lookup table)

Field Value Mappings

Below are listed the mappings for certain fields, specifying what each possible value of the field means.

Geocode Accuracy

Value	Description
1	Central Internal Position
2	General Internal Position
3	Transitional position
4	Street Location
5	Postcode unit position
9	Low accuracy - marked for priority review

Example Response

The following responses shows a IdmDataAddress record where the record contains a "PremiseLevelGeocode" group in the groupedAdditionalItems.

SOAP

<req:address>
    <data:organisation>gb group plc</data:organisation>
    <data:street>herons way</data:street>
    <data:town>chester</data:town>
    <data:postcode>ch4 9gb</data:postcode>
    <data:locality>chester business park</data:locality>
    <data:buildingname>the foundation</data:buildingname>
    <data:stateregion>cheshire</data:stateregion>
    <data:countrycode>gbr</data:countrycode>
    <data:dpszipplus>1ar</data:dpszipplus>
    <data:formattedaddress>gb group plc,the foundation,herons way chester business park,chester cheshire,ch4 9gb</data:formattedaddress>
    <data:geographicinformation>
        <data:easting>340009</data:easting>
        <data:northing>363191</data:northing>
        <data:latitude>53.1624456651</data:latitude>
        <data:longitude>-2.8987260320</data:longitude>
    </data:geographicinformation>
    <data:additionalitems>
        <data:item>
            <data:key>datasource</data:key>
            <data:value>names</data:value>
        </data:item>
    </data:additionalitems>
    <data:groupedadditionalitems>
        <data:name>premiselevelgeocode</data:name>
        <data:item>
            <data:key>licountry</data:key>
            <data:value>england</data:value>
        </data:item>
        <data:item>
            <data:key>lieasting</data:key>
            <data:value>340010.0</data:value>
        </data:item>
        <data:item>
            <data:key>linorthing</data:key>
            <data:value>363192.0</data:value>
        </data:item>
        <data:item>
            <data:key>lilat</data:key>
            <data:value>53.16247</data:value>
        </data:item>
        <data:item>
            <data:key>lilong</data:key>
            <data:value>-2.898713</data:value>
        </data:item>
        <data:item>
            <data:key>ligeoacc</data:key>
            <data:value>1</data:value>
        </data:item>
        <data:item>
            <data:key>ligeoaccd</data:key>
            <data:value>central internal position</data:value>
        </data:item>
    </data:groupedadditionalitems>
    <data:rmudprn>04624695</data:rmudprn>
</req:address>

REST

"address":[
    {
        "street":"kingsfield court",
        "town":"chester",
        "postcode":"ch4 9gb",
        "locality":"eccleston",
        "buildingname":"edward house",
        "stateregion":"cheshire",
        "countrycode":"gbr",
        "dpszipplus":"9zi",
        "formattedaddress":"edward house,kingsfield court,eccleston,chester,cheshire,ch4 9gb",
        "additionalitems":{
            "item":[
                {
                    "key":"datasource",
                    "value":"abp"
                }
            ]
        },
        "groupedadditionalitems":[
            {
                "name":"premiselevelgeocode",
                "item":[
                    {
                        "key":"licountry",
                        "value":"england"
                    },
                    {
                        "key":"lieasting",
                        "value":"340010.0"
                    },
                    {
                        "key":"linorthing",
                        "value":"363192.0"
                    },
                    {
                        "key":"lilat",
                        "value":"53.16247"
                    },
                    {
                        "key":"lilong",
                        "value":"-2.898713"
                    },
                    {
                        "key":"ligeoacc",
                        "value":"1"
                    },
                    {
                        "key":"ligeoaccd",
                        "value":"central internal position"
                    }
                ]
            }
        ]
    }
]