Reverse Geocode

Reverse geocode a location. Returns the nearest building to the location within the specified maxDistance.

Please read API Overview first

The Reverse Geocode API endpoint won't change. It can be set as a constant.

https://api.autoaddress.ie/2.0/ReverseGeocode

N.B. This EndPoint URL resolves to a dynamic IP address, please be aware of this when making DNS and Firewall decisions.

To reverse geocode a location, a simple  GET request from your desired language is all that is needed.

• cURL

curl -v "https://api.autoaddress.ie/2.0/ReverseGeocode?key=YOUR_KEY&longitude=LONGITUDE&latitude=LATITUDE&maxDistance=MAX_DISTANCE&vanityMode=true&addressProfileName=Demo5LineV2"

• jQuery

$.ajax({
   type: "GET",
   dataType: "jsonp",
   url: "https://api.autoaddress.ie/2.0/ReverseGeocode",
   data : {
       key: "YOUR_KEY",
       longitude: LONGITUDE,
       latitude: LATITUDE,
       maxDistance: MAX_DISTANCE,
       vanityMode: true,
       addressProfileName: "Demo5LineV2"
   },
   success: function(data){
       //do something with data
   }
});

• Angular JS

$http.jsonp('https://api.autoaddress.ie/2.0/ReverseGeocode',{
   params: {
      key: "YOUR_KEY",
       longitude: LONGITUDE,
       latitude: LATITUDE,
       maxDistance: MAX_DISTANCE,
       vanityMode: true,
       addressProfileName: "Demo5LineV2"
   }
}).success(function(data){
   //do something with data
});

• Ruby

require 'json'
require 'net/http'

uri = URI.parse("https://api.autoaddress.ie/2.0/ReverseGeocode?key=YOUR_KEY&longitude=LONGITUDE&latitude=LATITUDE&maxDistance=MAX_DISTANCE&vanityMode=true&addressProfileName=Demo5LineV2")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
response = http.get(uri.request_uri)
result = JSON.parse(response.body)

• Python

import json
import urllib2
 
Response = urllib2.urlopen ("https://api.autoaddress.ie/2.0/ReverseGeocode?key=YOUR_KEY&longitude=LONGITUDE&latitude=LATITUDE&maxDistance=MAX_DISTANCE&vanityMode=true&addressProfileName=Demo5LineV2")jsonResult = json.load(Response)

• C#

using System.IO;
using System.Net;

HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://api.autoaddress.ie/2.0/ReverseGeocode?key=YOUR_KEY&longitude=LONGITUDE&latitude=LATITUDE&maxDistance=MAX_DISTANCE&vanityMode=true&addressProfileName=Demo5LineV2");request.Method = WebRequestMethods.Http.Get;
request.Accept = "application/json";

using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
{
   var result = new StreamReader(response.GetResponseStream()).ReadToEnd();
}

The following is a sample JSON response returned for a Reverse Geocode API request.

{
  "hits": [
    {
      "addressId": 1401182204,
      "postalAddress": [
        "INNS COURT",
        "WINETAVERN STREET",
        "DUBLIN 8"
      ],
      "vanityAddress": [
        "Inns Court",
        "Winetavern Street",
        "Dublin 8"
      ],
      "reformattedAddress": [
        "Inns Court", 
        "Winetavern Street", 
        null, 
        null, 
        "Dublin 8" 
      ],
      "distance": 26.4,
      "links": [
        {
          "rel": "getEcadData",
          "href": "https://api.autoaddress.ie/2.0/getecaddata?key=YOUR_KEY&txn=dd588e57-004b-4850-bfc7-871e386f7585&ecadId=1401182204"
        }
      ]
    }
  ],
  "input": {
    "key": "YOUR_KEY",
    "txn": "dd588e57-004b-4850-bfc7-871e386f7585",
    "latitude": 53.343761,
    "longitude": -6.271796,
    "maxDistance": 50.0,
    "language": "en",
    "country": "ie",
    "vanityMode": true,
    "addressProfileName": "Demo5LineV2"
  },
  "links": [
    {
      "rel": "self",
      "href": "https://api.autoaddress.ie/2.0/reversegeocode?key=YOUR_KEY&longitude=-6.271796&latitude=53.343761&maxDistance=50&vanityMode=true&addressProfileName=Demo5LineV2"
    }
  ]
}

* Required Field