Dokumentation API v1

Entfernung

Dieser API-Aufruf berechnet die Fahrstrecke und die Zeit zwischen zwei Postleitzahlen.

Erforderliche Parameter

Geben Sie eine Kombination aus beiden niederländischen 4PP:

  • Von vier Seiten: Geben Sie eine niederländische Postleitzahl mit 4 Positionen ein.
  • to_nl_fourpp: Geben Sie eine niederländische Postleitzahl mit Postleitzahl 4 ein.

oder eine Kombination aus Niederländisch 6PP:

  • from_nl_sixpp: Geben Sie eine niederländische Postleitzahl ein, bevor Sie mit der Postleitzahl beginnen.
  • to_nl_sixpp: Geben Sie eine niederländische Postleitzahl mit Postleitzahl 6 ein.

Anmerkung: Da die DTM-Tabelle von jeder 6PP-Postleitzahl zu jeder anderen 6PP-Postleitzahl sehr groß wäre, werden nur die Postleitzahlen mit einer maximalen Entfernung von 5 km in den Datensatz aufgenommen. Wenn Sie wissen möchten, wie lange die Reisezeit oder die Entfernung zwischen den Postleitzahlen weiter auseinander liegt, kehren Sie nur zu den 4PP-Postleitzahlen zurück.

oder belgische Postleitzahlen:

  • von vier: Geben Sie eine belgische Startpostleitzahl ein.
  • to_be_fourpp: Geben Sie eine belgische Postleitzahl ein.

Optionale Parameter

  • algorithm: Wählen Sie einen Algorithmus aus. road, um die tatsächliche Fahrstrecke und -zeit auf tatsächlichen Straßen zu berechnen, oder straight, um die Entfernung in einer geraden Linie zu berechnen.

    Jedes Abonnement ermöglicht den Zugriff auf die Entfernung der Geraden, aber der Algorithmus verwendet die Lenkzeitmatrix (kürzester Weg), die bei Verwendung über die API eine "Entwicklungsagentur" oder ein höheres Abonnementlevel erfordert.

    Zu Testzwecken ist eine Reihe von Postleitzahlen pro Abonnementstufe erlaubt: 1000..1098, 1100..1108 (Amsterdam), 3000..3089 (Rotterdam), 5600..5658 (Eindhoven).

Beispiele

Unterwegs

In diesem Beispiel wird die Fahrstrecke und die Fahrzeit zwischen zwei niederländischen Postleitzahlen ermittelt.

GET https://api.pro6pp.nl/v1/distance?auth_key=YOUR_AUTH_KEY&from_nl_fourpp=5408&to_nl_fourpp=5652&algorithm=road HTTP/1.1
Content-Type: application/json; charset=utf-8


{
  "status": "ok",
  "results": {
    "distance": 36800,
    "duration": 24
  }
}

In einer geraden Linie

In diesem Beispiel wird der gerade Linienabstand zwischen zwei belgischen Postleitzahlen ermittelt. Das gewählte Ausgabeformat ist XML.

GET https://api.pro6pp.nl/v1/distance?auth_key=YOUR_AUTH_KEY&from_be_fourpp=2000&to_be_fourpp=4000&algorithm=straight&format=xml HTTP/1.1
Content-Type: application/xml; charset=utf-8


<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <results>
    <distance>105674</distance>
  </results>
</response>

Beispielcode

Die Methode distance wird in diesen Beispielen demonstriert:

Wir empfehlen Ihnen, einen Mustercode in Ihrer bevorzugten Sprache anzufordern. In der Zwischenzeit sollten Sie sich die Autovervollständigung ansehen, die bereits in vielen Sprachen demonstriert wurde.

Schritt-für-Schritt Beispiel in JavaScript

Schritt 1: Erstellen der HTML-Seite

Wir beginnen damit, eine leere HTML-Seite mit einer minimalen Webseitenstruktur zu erstellen.

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Distance tutorial</title>
  </head>
  <body></body>
</html>

Laden Sie unsere JavaScript-Bibliothek distance.js herunter, mit der wir den Pro6PP-Webservice in diese Webseite integrieren können. Kopieren Sie es in den gleichen Ordner, in dem Sie die obige Webseite gespeichert haben.

Füge den folgenden Code zwischen den Tags <body> und <body> hinzu.

Es werden die Eingabefelder für die Eingabe der Koordinaten hinzugefügt.

<form class="distance">
  From postcode: <input type="number" data-binding="from-nl-fourpp" /><br />
  To postcode: <input type="number" data-binding="to-nl-fourpp" /><br />
  <span data-binding="message"></span><br />
  Distance (meters): <input type="number" data-binding="distance" /> Duration (minutes):
  <input type="number" data-binding="duration" />
</form>

Schritt 2: Interaktion hinzufügen

Füge den folgenden Code zwischen den Tags <head> und </head> hinzu. Es schlägt mögliche Ortsnamen vor, während der Benutzer tippt.

<script src="https://code.jquery.com/jquery-1.11.2.min.js"></script>
<link rel="stylesheet" href="https://code.jquery.com/ui/1.11.2/themes/smoothness/jquery-ui.css" />
<script src="https://code.jquery.com/ui/1.11.2/jquery-ui.min.js"></script>
<script src="distance.js"></script>
<script>
  var pro6ppAuthKey = 'YOUR AUTH_KEY';
  var algorithm = 'road'; // or 'straight'
  $(document).ready(function() {
    $('.distance').applyDistance({
      algorithm: algorithm,
      pro6ppAuthKey: pro6ppAuthKey,
    });
  });
</script>

Schritt 3: Lass es funktionieren

Um auf den Pro6PP-Webservice zuzugreifen, müssen Sie Ihren persönlichen Autorisierungsschlüssel anfordern. Dieser Schlüssel wird Ihnen unmittelbar nach der Anmeldung per E-Mail zugesandt.

Ersetzen Sie die obige temporäre Angabe YOUR AUTH_KEY durch Ihren persönlichen Autorisierungsschlüssel.

Schritt 4: Sehen Sie es in Aktion

Öffnen Sie distance.html in Ihrem Browser. Es ist gebrauchsfertig!
Funktioniert es nicht? Versuchen Sie, den vorgefertigten Beispielcode von der Seite example code herunterzuladen.