API documentation

Reverse

Given the location (latitude and longitude in at least 2 decimal places), receive province, municipality, place. At 4 decimal places, the 6-character postcode and street are also returned.

Required parameters

  • lat: specify the latitude component of the location.
  • lng: specify the longitude component of the location.

Result example

undefined/v1/reverse?auth_key=YOUR_AUTH_KEY&lat=51.5676&lng=5.0862

This request gives the following result:

{
  "status": "ok",
  "results": {
    "precision": 8,
    "province": "Noord-Brabant",
    "municipality": "Tilburg",
    "city": "Tilburg",
    "streets": ["Veldhovenring"],
    "nl_sixpp": "5041BC",
    "lat": 51.56764,
    "lng": 5.08622
  }
}

Example code

The reverse method is demonstrated in these ready-to-use examples:

We encourage you to request example code in the language you prefer. In the meantime, you might want to look at the autocomplete method, which is already demonstrated in many languages.

Step by step example in JavaScript

Step 1: build the HTML page

We start by creating an empty HTML page, containing a minimal web page structure.

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Reverse tutorial</title>
  </head>
  <body></body>
</html>

Download our JavaScript library reverse.js that allows us to integrate the Pro6PP webservice into this web page. Copy it in the same directory as you saved the above web page.

Add the following code between the <body> and </body> tags.

It adds the input fields for entering the reverse.

<form action="#" class="reverse">
  Latitude: <input class="lat" /><br />
  Longitude: <input class="lng" /><br />
  <input type="submit" />
  <span class="message"></span><br />
  City: <input class="city" />
</form>

Step 2: add interaction

Add the following code between the <head> and <head> tags. It suggests possible city names while the user is typing.

<script src="https://code.jquery.com/jquery-1.11.2.min.js"></script>
<link rel="stylesheet" href="https://code.jquery.com/ui/1.11.2/themes/smoothness/jquery-ui.css" />
<script src="https://code.jquery.com/ui/1.11.2/jquery-ui.min.js"></script>
<script src="reverse.js"></script>
<script>
  var pro6pp_auth_key = 'YOUR AUTH_KEY';
  $(document).ready(function() {
    $('.reverse').applyReverseSubmit();
  });
</script>

Step 3: make it work

To access the Pro6PP webservice, you need to request your personal authorization key. This key is emailed to you right after signing up.

Replace the above placeholder YOUR AUTH_KEY with your personal authorization key.

Step 4: see it in action

Open reverse.html in your browser. It’s ready to use!
It doesn’t work? Try downloading the ready-to-use example code at the example code page.