Reverse Global

Overview

ParametersQuery string

Responses

200Address found

Netherlands

Field	Type	Example value	Description
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"
}

Errors

{
  "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"
    }
  ]
}

Code examples

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

We encourage you to request example code in the language you prefer.

Step by step

Set up a quick form to try out the Global Reverse functionality by following the steps below.

1. Build the HTML page

   We start by creating an empty HTML page, containing a minimal web page structure. Create a new .html file named pro6pp_global_reverse.html. Add the following code between the <body> and </body> tags. It adds the input fields for entering the address.

   pro6pp_global_reverse.htmlCopy

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

   Show full code

2. Add interaction

   Add the following JavaScript code in a separate pro6pp_global_reverse.js file. The IDs and Class names of the HTML elements should match with the ones specified in this JavaScript file in order to get the correct results.

   pro6pp_global_reverse.jsCopy

   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);
       }
   });

   Show full code

3. Make it work

   Link the JavaScript file inside the pro6pp_global_reverse.html right before closing the </body> tag.

   pro6pp_global_reverse.htmlCopy

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

   To access the Pro6PP web service, you need to request your personal authorization key. This key is emailed to you right after signing up. Replace the above placeholder AUTH_KEY with your personal authorization key.

   If you don’t have an account yet, sign up for a free 2-month trial. After creating your account, go to your Subscription details and copy your AUTH_KEY. You’ll need this key to authenticate your requests.

4. See it in action

   Once you’ve completed the previous steps, it’s time to run the form locally in your browser. You should now have two files in the same folder on your computer:

   • pro6pp_global_reverse.html - the HTML page with the form.
   • pro6pp_global_reverse.js - the JavaScript file that handles the interaction.

   You can now open the HTML file in your browser by simply double-clicking it in your file explorer (e.g., Finder on macOS or File Explorer on Windows). Alternatively, you can open it manually in the browser using the full file:/// path. For example:

   Example file pathsCopy

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

   Once the page opens, start typing in the form fields and hit Submit to see the API response displayed in the “Full Response” section.