Technische Details/FAQ
Die nachfolgenden Informationen sind geschrieben für Web-Dienstleister, die die Funktionalität von Edith: Distance auf den Seiten ihrer Kunden integrieren möchten.
- Welche Technik verwendet Edith: Distance?
- Welche Voraussetzungen muss ich haben, um Edith: Distance einbinden zu können
- Gibt es Parameter, mit denen ich die Suche beeinflussen kann?
- Was muss ich tun, um Edith: Distance in meine Seiten zu integrieren?
- Wie genau werden die Entfernungen angegeben?
- Wie kann ich die Geokoordinaten zurück geliefert bekommen?
- Wie können die Geokoordinaten an Kartendienste übergeben werden?
Welche Technik verwendet Edith: Distance?
Edith: Distance ist ein XML-RPC-basierter Web Service.
Das XML-RPC-Protokoll bietet die Möglichkeit, Skripte auf entfernten Servern auszuführen, als wären es lokale Funktionen. Das bedeutet für Sie, dass Sie Edith: Distance in Ihren serverseitigen Skripten aufrufen und die zurückgelieferten Postleitzahlen, Orte und Entfernungen mit Ihren Skripten beliebig weiterverarbeiten und darstellen können.
Siehe dazu auch unser Anwendungs-Szenario
Vorteile
- Sie haben keine langen Einrichtzeiten
- Die Einbindung geht schnell und unkompliziert
- Sie arbeiten immer mit aktuellen Daten
Welche Voraussetzungen muss ich haben, um Edith: Distance einbinden zu können
- Eine serverseitige Programmiersprache (PHP, Perl, Java, ASP, Python, etc).
- Eine XML-RPC-Bibliothek für Ihre Programmiersprache.
Gibt es Parameter, mit denen ich die Suche beeinflussen kann?
Ja. Sie können weitere Parameter übergeben, um die Anzahl der zurückgegebenen Werte und deren Sortierung zu beeinflussen. Genauere Details zu den Parametern und den von Edith: Distance zurückgelieferten Fehlercodes entnehmen Sie bitte der Dokumentation zu Edith: Distance.
Falls Sie weitere Möglichkeiten wünschen, können wir Edith: Distance für Sie anpassen!
Was muss ich tun, um Edith: Distance in meine Seiten zu integrieren?
- Lizenz kaufen.
- Sie teilen uns die IP-Adresse des Zielservers mit.
(Wenn gewünscht, können Sie uns zusätzlich auch die IP-Adresse des Testservers nennen) - Sie bekommen dann von uns eine Kundennummer per E-Mail zugeschickt.
- Diese Kundennummer integrieren Sie in den Funktionsaufruf von Edith: Distance. Die Gestaltung der Ergebnismenge ist vollkommen beliebig und liegt ganz bei Ihren
- Fertig!
Genauere Details zu den Parametern und den von Edith: Distance zurückgelieferten Fehlercodes entnehmen Sie bitte der Dokumentation zu Edith: Distance.
Wie genau werden die Entfernungen angegeben?
Die Entfernungen werden nur "ungefähr" angegeben. Die nachfolgenden Grafiken zeigen die Hintergründe.
Jedes PLZ-Gebiet beschreibt ein Polygon.
Die Entfernung zwischen zwei PLZ-Gebieten...
...entspricht dem Abstand der Mittelpunkte, die als Rechteck um das Polygon gezogen werden.
Wie kann ich die Geokoordinaten zurück geliefert bekommen?
Übergeben Sie als optionalen Parameter lediglich folgenden Code:
XMLRPC_prepare(
array(
"koordinaten"=>1
)
)
Die Geokoordinaten der PLZ-Gebiete werden im WGS84-Format zurück gegeben. Diese Koordinaten werden von nahezu allen auf dem Markt vorhandenen Kartensystemen unterstützt bzw. vorausgesetzt.
Wie können die Geokoordinaten an Kartendienste übergeben werden?
Das ist abhängig von dem Kartenanbieter. Grundsätzlich müssen aber lediglich die Geokoordinaten an den Kartenanbieter übergeben werden. Zum Beispiel als URL-Parameter oder in einer JavaScript-Konfigurationsdatei.
Beispiele zum Einbinden von Kartendiensten:
- Einbindung von Locator: K4-Karten,
PDF-Dokument - Einbinden von GoogleMaps:
Sehr gute Einführung auf akademie.de
