Reverse geocoding with postcode-level data

Return a street-level address and geodata from latitude and longitude (e.g. 52.5859714116,1.3492192897)

Lookup cost: 1.9 credits

Request structure

http://ws.postcoder.com/pcw/[api-key]/rgeo/uk/[latitude]/[longitude]?distance=[distance-in-metres]

Optional parameters

lines The number of lines over which to split each address
include Include extra address fields within the address lines returned (see above)
exclude Exclude address fields within the address lines returned (see above)
format xml | json (default unless header of application/xml is detected)
addtags Add extra address fields to the return
identifier Identify your lookups to make debugging and reviewing stats easier
callback Use to specify the name of your JSONP callback function

Notes:

  • Multiple items may be returned depending on your search criteria.
  • The distance query string parameter distance has a default value of 50 metres if not supplied.
  • When deciding the value you should consider that the higher the number the more results will be returned. This could result in a lot of data being returned if a large value like 500 metres is used, especially in densely populated areas like London.
  • Having latitude and longitude values with less than five decimal places may also affect the number of results.

Response examples

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/rgeo/uk/52.5859714116/1.3492192897?distance=50&format=json - View live response

[
    {
        "summaryline":"Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ",
        "dependentstreet":"",
        "street":"Fox Road",
        "doubledependentlocality":"",
        "dependentlocality":"Framingham Pigot",
        "posttown":"Norwich",
        "county":"Norfolk",
        "postcode":"NR14 7PZ",
        "latitude":"52.5859714116",
        "longitude":"1.3492192897",
        "grideasting":"626980",
        "gridnorthing":"0303951"
    }
]

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/rgeo/UK/52.5859714116/1.3492192897?distance=50&format=xml - View live response

<Addresses xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Address>
        <summaryline>Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ</summaryline>
        <dependentstreet/>
        <street>Fox Road</street>
        <doubledependentlocality/>
        <dependentlocality>Framingham Pigot</dependentlocality>
        <posttown>Norwich</posttown>
        <county>Norfolk</county>
        <postcode>NR14 7PZ</postcode>
        <latitude>52.5859714116</latitude>
        <longitude>1.3492192897</longitude>
        <grideasting>626980</grideasting>
        <gridnorthing>0303951</gridnorthing>
    </Address>
</Addresses>

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/rgeo/uk/52.5859714116/1.3492192897?distance=50&format=json&lines=3 - View live response

[
    {
        "addressline1":"Fox Road",
        "addressline2":"Framingham Pigot",
        "summaryline":"Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ",
        "dependentstreet":"",
        "street":"Fox Road",
        "doubledependentlocality":"",
        "dependentlocality":"Framingham Pigot",
        "posttown":"Norwich",
        "county":"Norfolk",
        "postcode":"NR14 7PZ",
        "latitude":"52.5859714116",
        "longitude":"1.3492192897",
        "grideasting":"626980",
        "gridnorthing":"0303951"
    }
]

Response field descriptions

Field name Data type Description Example
summaryline String Summary Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ
dependentstreet String Dependent street
street String Street Fox Road
doubledependentlocality String Double dependent locality
dependentlocality String Dependent locality Framingham Pigot
posttown String Post town Norwich
county String County Norfolk
postcode String Postcode NR14 7PZ
latitude Float Latitude coordinate value 52.5859714116
longitude Float Longitude coordinate value 1.3492192897
grideasting Integer Ordnance Survey Easting coordinate at 100m precision in units of 10m 626980
gridnorthing Integer Ordnance Survey Northing coordinate at 100m precision in units of 10m 0303951