Documentatie API v1

Reverse

Gegeven de locatie (latitude en longitude in minimaal 2 decimalen), ontvang provincie, gemeente, plaats. Bij 4 decimalen wordt ook de 6 karakter postcode en straat geretourneerd.

Verplichte parameters

  • lat: geef de latitude component van de locatie op.
  • lng: geef de longitude component van de locatie op.

Resultaat voorbeeld

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

Deze aanvraag geeft het volgende resultaat:

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

Voorbeeldcode

De reverse methode wordt gedemonstreerd in deze gebruiksklare voorbeelden:

We moedigen u aan om voorbeeldcode aan te vragen in de taal van uw voorkeur. In de tussentijd wilt u misschien kijken naar de autocomplete methode, die al in vele talen is gedemonstreerd.

Stap voor stap voorbeeld in JavaScript

Stap 1: bouw de HTML-pagina

We beginnen met het maken van een lege HTML-pagina met een minimale webpagina structuur.

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

Download onze JavaScript bibliotheek reverse.js waarmee we de Pro6PP webservice kunnen integreren in deze webpagina. Kopieer het in dezelfde map als waarin u de bovenstaande webpagina hebt opgeslagen.

Voeg de volgende code toe tussen de tags <body> en </body>.

Het voegt de invoervelden toe voor het invoeren van het omgekeerde.

<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>

Stap 2: voeg interactie toe

Voeg de volgende code toe tussen de tags <head> en <head>. Het suggereert mogelijke plaatsnamen terwijl de gebruiker aan het typen is.

<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>

Stap 3: laat het werken

Om toegang te krijgen tot de Pro6PP webservice, moet u uw persoonlijke autorisatiesleutel aanvragen. Deze sleutel wordt direct na signing up naar u gemaild.

Vervang de bovenstaande tijdelijke aanduiding YOUR AUTH_KEY door uw persoonlijke autorisatiesleutel.

Stap 4: zie het in actie

Open reverse.html in uw browser. Het is klaar voor gebruik!
Het werkt niet? Probeer de kant-en-klare voorbeeldcode te downloaden op de pagina example code.