Reverse Mondial

Vue d'ensemble

ParamètresChaîne de requête

Réponses

200Address found

Netherlands

Champ	Type	Valeur d'exemple	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"
}

Erreurs

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

Exemples de code

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

Nous vous encourageons à demander un exemple de code dans votre langue préférée.

Pas à pas

Créez un formulaire rapide pour tester la fonctionnalité Mondial Reverse en suivant les étapes ci-dessous.

1. Créez la page HTML

   Nous commençons par créer une page HTML vide, contenant une structure de page web minimale. Créez un nouveau fichier .html nommé pro6pp_mondial_reverse.html. Ajoutez le code suivant entre les balises <body> et </body>. Cela ajoute les champs de saisie pour saisir l'adresse.

   pro6pp_mondial_reverse.htmlCopier

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

   Afficher tout le code

2. Ajoutez une interaction

   Ajoutez le code JavaScript suivant dans un fichier pro6pp_mondial_reverse.js séparé. Les ID et les noms de classe des éléments HTML doivent correspondre à ceux spécifiés dans ce fichier JavaScript afin d'obtenir des résultats corrects.

   pro6pp_mondial_reverse.jsCopier

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

   Afficher tout le code

3. Faites-le fonctionner

   Liez le fichier JavaScript à l'intérieur du pro6pp_mondial_reverse.html fichier juste avant de fermer la balise </body>.

   pro6pp_mondial_reverse.htmlCopier

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

   Pour accéder au service Web Pro6PP, vous devez demander votre clé d'autorisation personnelle. Cette clé vous est envoyée par e-mail juste après votre inscription. Remplacez l'espace réservé ci-dessus AUTH_KEY par votre clé d'autorisation personnelle.

   Si vous n'avez pas encore de compte, inscrivez-vous pour un essai gratuit de 2 mois. Après avoir créé votre compte, allez dans les détails de votre abonnement et copiez votre AUTH_KEY. Vous aurez besoin de cette clé pour authentifier vos demandes.

4. Le voir en action

   Une fois que vous avez terminé les étapes précédentes, il est temps de exécuter le formulaire localement dans votre navigateur. Vous devriez maintenant avoir deux fichiers dans le même dossier sur votre ordinateur :

   • pro6pp_mondial_reverse.html - la page HTML contenant le formulaire.
   • pro6pp_mondial_reverse.js - le fichier JavaScript qui gère l'interaction.

   Vous pouvez maintenant ouvrir le fichier HTML dans votre navigateur en double-cliquant dans votre explorateur de fichiers (par exemple, Finder sous macOS ou Explorateur de fichiers sous Windows). Vous pouvez également l'ouvrir manuellement dans le navigateur en utilisant le chemin complet file:///. Par exemple, vous pouvez ouvrir le fichier en utilisant le chemin complet file:/// :

   Exemples de chemins d'accès aux fichiersCopier

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

   Une fois la page ouverte, commencez à saisir les champs du formulaire et cliquez sur Submit pour voir la réponse de l'API s'afficher dans la section « Full Response ».