Reverse Globalt

Oversigt

ParametreQuerystreng

Svar

200Address found

Netherlands

Felt	Type	Eksempelværdi	Beskrivelse
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"
}

Fejl

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

Kodeeksempler

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

Vi opfordrer dig til at anmode om eksempelkode på det sprog, du foretrækker.

Trin for trin

Opret en hurtig formular for at afprøve Globalt Reverse -funktionaliteten ved at følge nedenstående trin.

1. Opbyg HTML-siden

   Vi starter med at oprette en tom HTML-side, der indeholder en minimal websidestruktur. Opret en ny .html fil med navnet pro6pp_globalt_reverse.html. Tilføj følgende kode mellem <body> og </body> tags. Den tilføjer inputfelter til indtastning af adressen.

   pro6pp_globalt_reverse.htmlKopiér

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

   Vis hele koden

2. Tilføj interaktion

   Tilføj følgende JavaScript-kode i en separat pro6pp_globalt_reverse.js-fil. HTML-elementernes ID'er og klassenavne skal stemme overens med dem, der er angivet i denne JavaScript-fil, for at få de korrekte resultater.

   pro6pp_globalt_reverse.jsKopiér

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

   Vis hele koden

3. Få det til at fungere

   Link JavaScript-filen inde i pro6pp_globalt_reverse.html lige før du lukker </body>-tagget.

   pro6pp_globalt_reverse.htmlKopiér

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

   For at få adgang til Pro6PP-webservicen skal du anmode om din personlige autorisationsnøgle. Denne nøgle sendes til dig via e-mail lige efter tilmelding. Erstat ovenstående pladsholder AUTH_KEY med din personlige autorisationsnøgle.

   Hvis du ikke har en konto endnu, kan du tilmelde dig en gratis prøveperiode på 2 måneder. Når du har oprettet din konto, skal du gå til dine abonnementsoplysninger og kopiere din AUTH_KEY. Du skal bruge denne nøgle til at godkende dine anmodninger.

4. Se det i aktion

   Når du har gennemført de foregående trin, er det tid til at køre formularen lokalt i din browser. Du bør nu have to filer i den samme mappe på din computer:

   • pro6pp_globalt_reverse.html - HTML-siden
   • pro6pp_globalt_reverse.js - den JavaScript-fil, der håndterer interaktionen.

   Du kan nu åbne HTML-filen i din browser ved blot at dobbeltklikke på den i din filudforsker (f.eks. Finder på macOS eller File Explorer på Windows). Alternativt kan du åbne den manuelt i browseren ved at bruge den fulde file:///-sti. For eksempel:

   Eksempel på filstierKopiér

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

   Når siden åbnes, skal du begynde at skrive i formularfelterne og trykke på Submit for at se API-svaret blive vist i afsnittet »Full Response«.