Reverse Global

Overzicht

ParametersQuerystring

Antwoorden

200Address found

Netherlands

Veld	Type	Voorbeeldwaarde	Beschrijving
country	string	"Netherlands"	English name of the country: "Netherlands".
lat	number	53.21358	Latitude of the address found, or of a central point of the street at street precision, in WGS84 decimal degrees rounded to five decimals.
lng	number	6.56172	Longitude of the address found, or of a central point of the street at street precision, in WGS84 decimal degrees rounded to five decimals.
municipality	string	"Groningen"	The municipality (gemeente) the result lies in.
postcodes	array of string	["9711AA"]	At street precision every postal code on the street, sorted; at streetnumber precision the postal code of the address found.
province	string	"Groningen"	The province (provincie) the result lies in.
settlement	string	"Groningen"	The BAG place of residence (woonplaats) the result lies in.
street	string	"Praediniussingel"	The name of the street found.
streetnumber	string	"1"	House number of the address found with its premise appended, such as "4A"; present only at streetnumber precision.

{
  "country": "Netherlands",
  "lat": 53.21358,
  "lng": 6.56172,
  "municipality": "Groningen",
  "postcodes": [
    "9711AA"
  ],
  "province": "Groningen",
  "settlement": "Groningen",
  "street": "Praediniussingel",
  "streetnumber": "1"
}

Fouten

{
  "error_id": "MISSING_PARAMETER",
  "errors": [
    {
      "message": "Required parameter lat is missing",
      "help": "https://pro6pp.nl/docs/v2/redoc",
      "parameter": "lat"
    }
  ]
}

{
  "error_id": "INVALID_PARAMETER_TYPE",
  "errors": [
    {
      "message": "parameter: lat has invalid 1,0, should be number",
      "help": "https://pro6pp.nl/docs/v2/redoc",
      "parameter": "lat"
    }
  ]
}

{
  "error_id": "INVALID_VALUE",
  "errors": [
    {
      "message": "value is invalid",
      "help": "https://pro6pp.nl/docs/v2/redoc",
      "parameter": "postalCode",
      "value": "invalid"
    }
  ]
}

{
  "error_id": "UNAUTHORIZED",
  "errors": [
    {
      "message": "No authorization token provided",
      "help": "https://pro6pp.nl/docs/v2/redoc#section/Authentication"
    }
  ]
}

{
  "error_id": "BAD_SUBSCRIPTION_TYPE",
  "errors": [
    {
      "message": "['LU', 'FR'] reverse API calls are not available for this subscription type. Please upgrade your subscription to add extra country support.",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2.reverse.worldwide.api.handler"
    }
  ]
}

{
  "error_id": "OUTSIDE_SERVICE_AREA",
  "errors": [
    {
      "message": "This lat/lng combination is outside of our service area",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2.reverse.worldwide.api.handler"
    }
  ]
}

{
  "error_id": "NO_RESULTS_FOUND",
  "errors": [
    {
      "message": "No results found",
      "help": "https://pro6pp.nl/docs/v2/redoc"
    }
  ]
}

Codevoorbeelden

curl "https://api.pro6pp.nl/v2/reverse/global?lat=52.36691&lng=4.89489&authKey=YOUR_API_KEY"

Wij moedigen u aan om voorbeeldcode aan te vragen in de taal van uw voorkeur.

Stap voor stap

Stel snel een formulier in om de functionaliteit Global Reverse uit te proberen door de onderstaande stappen te volgen.

1. Bouw de HTML-pagina

   We beginnen met het maken van een lege HTML-pagina, die een minimale webpaginastructuur bevat. Voeg de volgende code toe tussen de tags <body> en </body>. Het voegt de invoervelden toe voor het invoeren van het adres. Maak een nieuw .html bestand met de naam {filename}}.

   pro6pp_global_reverse.htmlKopiëren

   <form class="form" id="form">
     <div>Call</div>
     <div>
       <label for="lat">lat:</label>
       <input id="lat" class="lat" placeholder="52.36691"/>
       <label for="lng">lng:</label>
       <input id="lng" class="lng" placeholder="4.89489"/>
       <label for="precision">precision:</label>
       <input id="precision" class="precision" placeholder=""/>
     </div>
     <div>
       <span style="color: red" class="message"></span>
     </div>
     <div>
       <button type="submit">Submit</button>
     </div>
     <br />
     <div>Response</div>
     <br />
     <div>Full Response</div>
     <pre class="jsonResponse"></pre>
   </form>

   Volledige code tonen

2. Voeg interactie toe

   Voeg de volgende JavaScript-code toe in een apart {filename}}-bestand. De ID's en Class-namen van de HTML-elementen moeten overeenkomen met die in dit JavaScript-bestand om de juiste resultaten te krijgen.

   pro6pp_global_reverse.jsKopiëren

   document.addEventListener("DOMContentLoaded", function() {
       const pro6ppAuthKey = "AUTH_KEY"; // Replace with your actual authorization key
   
       let messageSpan = document.querySelector(".message");
       let jsonResponseSpan = document.querySelector(".jsonResponse");
       const BASE_URL = "https://api.pro6pp.nl/v2";
   
       function fetchAddress(authKey) {
           const queryParams = {
               lat: document.getElementById("lat").value,
               lng: document.getElementById("lng").value,
               authKey: authKey
           };
           const optionalQueryParams = [
               "precision",
           ];
           for (const name of optionalQueryParams) {
               const value = document.getElementById(name).value;
               if (value !== "") {
                   queryParams[name] = value;
               }
           }
   
           let encodedUrl = new URL(`${BASE_URL}/reverse/global`);
           encodedUrl.search = new URLSearchParams(queryParams);
   
           fetch(encodedUrl)
               .then(async (response) => {
                   const data = await response.json();
                   if (data) {
                       messageSpan.textContent = "";
                       jsonResponseSpan.textContent = JSON.stringify(data, null, 2);
                   }
               })
               .catch((error) => {
                   console.error("Error fetching: ", error);
                   messageSpan.textContent = error.message;
               });
       }
   
       const form = document.getElementById("form");
       form.onsubmit = function (event) {
           event.preventDefault();
           fetchAddress(pro6ppAuthKey);
       }
   });

   Volledige code tonen

3. Laat het werken

   Koppel het JavaScript-bestand binnen de pro6pp_global_reverse.html vlak voor het sluiten van de code </body>.

   pro6pp_global_reverse.htmlKopiëren

     ...
     <script src="pro6pp_global_reverse.js"></script>
    </body>
   </html>

   Om toegang te krijgen tot de Pro6PP web service, moet u uw persoonlijke autorisatiesleutel aanvragen. Deze sleutel wordt direct na aanmelden naar u gemaild. Vervang de tijdelijke aanduiding AUTH_KEY door uw persoonlijke autorisatiesleutel.

   Als u nog geen account heeft, meldt u zich dan aan voor een gratis proefabonnement van 2 maanden. Nadat u uw account hebt aangemaakt, gaat u naar uw Abonnementsgegevens en kopieert u uw AUTH_KEY. U heeft deze sleutel nodig om uw aanvragen te verifiëren.

4. Zie het in actie

   Als u de vorige stappen heeft uitgevoerd, is het tijd om het formulier lokaal in uw browser uit te voeren. U zou nu twee bestanden in dezelfde map op uw computer moeten hebben:

   • pro6pp_global_reverse.html - de HTML-pagina met het formulier.
   • pro6pp_global_reverse.js - het JavaScript-bestand dat de interactie afhandelt.

   U kunt het HTML-bestand nu openen in uw browser door er simpelweg dubbel op te klikken in uw bestandsverkenner (bijvoorbeeld Finder op macOS of File Explorer op Windows). U kunt het ook handmatig in de browser openen met het volledige file:/// pad. Bijvoorbeeld:

   Voorbeeld bestandspadenKopiëren

   file:///C:/Users/YourName/Documents/pro6pp_global_reverse.html
   file:///Users/yourname/Desktop/pro6pp_global_reverse.html

   Zodra de pagina wordt geopend, begint u met het typen van de formuliervelden en drukt u op Submit om het API-antwoord te zien in het gedeelte “Full Response”.