Reverse Globale

Panoramica

ParametriQuery string

Risposte

200Address found

Netherlands

Campo	Tipo	Valore di esempio	Descrizione
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"
}

Errori

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

Esempi di codice

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

La invitiamo a richiedere codice di esempio nel linguaggio di programmazione che preferisce.

Passo dopo passo

Seguendo i passaggi seguenti, crei un semplice modulo per provare la funzionalità Globale Reverse.

1. Creare la pagina HTML

   Iniziamo creando una pagina HTML vuota con una struttura web minima. Crei un nuovo file .html denominato pro6pp_globale_reverse.html. Aggiunga il seguente codice tra i tag <body> e </body>. Questo codice aggiunge i campi di input per l'inserimento dell'indirizzo.

   pro6pp_globale_reverse.htmlCopi

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

   Mostri il codice completo

2. Aggiungere l'interazione

   Aggiunga il seguente codice JavaScript in un file separato pro6pp_globale_reverse.js. Gli IDs e i nomi delle classi (Class) degli elementi HTML devono corrispondere a quelli indicati in questo file JavaScript per ottenere i risultati corretti.

   pro6pp_globale_reverse.jsCopi

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

   Mostri il codice completo

3. Farlo funzionare

   Colleghi il file JavaScript all'interno di pro6pp_globale_reverse.html subito prima del tag di chiusura </body>.

   pro6pp_globale_reverse.htmlCopi

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

   Per accedere al servizio web Pro6PP è necessario richiedere la Sua chiave di autorizzazione personale. La chiave Le viene inviata via e-mail subito dopo la registrazione. Sostituisca il segnaposto AUTH_KEY indicato sopra con la Sua chiave di autorizzazione personale.

   Se non ha ancora un account, si registri per una prova gratuita di 2 mesi. Dopo aver creato l'account, vada in Dettagli abbonamento e copi la Sua AUTH_KEY. Questa chiave Le servirà per autenticare le Sue richieste.

4. Vederlo in azione

   Una volta completati i passaggi precedenti, è il momento di eseguire il modulo in locale nel Suo browser. Ora dovrebbe avere due file nella stessa cartella del Suo computer:

   • pro6pp_globale_reverse.html - la pagina HTML con il modulo.
   • pro6pp_globale_reverse.js - il file JavaScript che gestisce l'interazione.

   Ora può aprire il file HTML nel Suo browser semplicemente facendo doppio clic su di esso nel gestore file (ad es. Finder su macOS o File Explorer su Windows). In alternativa, può aprirlo manualmente nel browser utilizzando il percorso completo file:///. Ad esempio:

   Percorsi file di esempioCopi

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

   Una volta aperta la pagina, inizi a digitare nei campi del modulo e prema Submit per visualizzare la risposta dell'API nella sezione "Full Response".