Range Holland

Oversigt

ParametreQuerystreng

Svar

[
  {
    "postalCode": "1000",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1001",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1002",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1003",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1005",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1006",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1007",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1008",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1009",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  },
  {
    "postalCode": "1014",
    "distance": 223,
    "lat": 52.375,
    "lng": 4.899
  }
]

Fejl

{
  "error_id": "MISSING_PARAMETER",
  "errors": [
    {
      "message": "Required parameter postalCode is missing",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2_generic.range.router.nl",
      "parameter": "postalCode"
    },
    {
      "message": "Required parameter settlement is missing",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2_generic.range.router.nl",
      "parameter": "settlement"
    }
  ]
}

{
  "error_id": "INVALID_PARAMETER_TYPE",
  "errors": [
    {
      "message": "parameter: searchRange has invalid 5km, should be integer",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2_generic.range.router.nl",
      "parameter": "searchRange"
    }
  ]
}

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

{
  "error_id": "MULTIPLE_RESULTS_FOUND",
  "errors": [
    {
      "message": "Multiple results found",
      "help": "https://pro6pp.nl/docs/v2/redoc#operation/public_api.v2_generic.range.router.nl"
    }
  ]
}

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

Kodeeksempler

curl "https://api.pro6pp.nl/v2/range/nl?postalCode=1012&settlement=Amsterdam&municipality=Amsterdam&province=Noord-Holland&searchRange=10000&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 Holland Range -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_holland_range.html. Tilføj følgende kode mellem <body> og </body> tags. Den tilføjer inputfelter til indtastning af adressen.

   pro6pp_holland_range.htmlKopiér

   <form class="form" id="form">
     <div>Call</div>
     <div>
       <label for="postalCode">postalCode:</label>
       <input id="postalCode" class="postalCode" placeholder="1012"/>
       <label for="settlement">settlement:</label>
       <input id="settlement" class="settlement" placeholder="Amsterdam"/>
       <label for="municipality">municipality:</label>
       <input id="municipality" class="municipality" placeholder="Amsterdam"/>
       <label for="province">province:</label>
       <input id="province" class="province" placeholder="Noord-Holland"/>
       <label for="searchRange">searchRange:</label>
       <input id="searchRange" class="searchRange" placeholder="10000"/>
       <label for="precision">precision:</label>
       <input id="precision" class="precision" placeholder=""/>
       <label for="maxResults">maxResults:</label>
       <input id="maxResults" class="maxResults" placeholder=""/>
       <label for="includeInitialPostalCode">includeInitialPostalCode:</label>
       <input id="includeInitialPostalCode" class="includeInitialPostalCode" 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_holland_range.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_holland_range.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 = {
               authKey: authKey
           };
           const optionalQueryParams = [
               "postalCode",
               "settlement",
               "municipality",
               "province",
               "searchRange",
               "precision",
               "maxResults",
               "includeInitialPostalCode",
           ];
           for (const name of optionalQueryParams) {
               const value = document.getElementById(name).value;
               if (value !== "") {
                   queryParams[name] = value;
               }
           }
   
           let encodedUrl = new URL(`${BASE_URL}/range/nl`);
           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_holland_range.html lige før du lukker </body>-tagget.

   pro6pp_holland_range.htmlKopiér

     ...
     <script src="pro6pp_holland_range.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_holland_range.html - HTML-siden
   • pro6pp_holland_range.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_holland_range.html
   file:///Users/yourname/Desktop/pro6pp_holland_range.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«.