Vor allem für Internet-Dienstleister, die unseren Service für Ihre Kunden einbinden möchten, sind weiterführende Informationen (technische Spezifikationen, Integrationsbeispiele etc.) von Interesse. Diese haben wir nachfolgend für Sie zusammengestellt.
Bei offenen Fragen nehmen Sie bitte Kontakt mit uns auf.

Technische Voraussetzungen / Integration

Weitere Produktmerkmale

Testzugang und Lizenzkauf

Referenzen



Welche Technik verwendet ebaas distance?

Es stehen zwei Spezifikationen zur Verfügung, um die Funktionen von ebaas distance zu nutzen: XML-RPC und SOAPWSDL.

Der Web Service ebaas distance kann per XML-RPC oder SOAP/WSDL eingebunden werden:
XML-RPC und SOAP/WSDL sind ein Protokolle für entfernte Funktionsaufrufe über das Internet (HTTP Protokoll). RPC steht hier für die Bezeichnung Remote Procedure Call. Beide Protokolle benutzen XML um die Input-Parameter an die entfernten Webservice Methoden zu übertragen und die Output-Parameter an das aufrufende Script zurück zu liefern. Die Web Services Description Language (WSDL) ist eine öffentliche XML Formatierung, die der Beschreibung des SOAP Webservices dient.

Ausführliche Informationen zur XML-RPC Spezifikation (Datei-Aufbau, Variablen-Typen, Fehler-Syntax etc.):
http://www.xmlrpc.com oder
http://www.xml-rpc.de oder
http://de.wikipedia.org/wiki/XML-RPC.

Ausführliche Informationen zur SOAP/WSDL Spezifikation (Datei-Aufbau, Variablen-Typen, Fehler-Syntax etc.):
http://www.w3.org/TR/wsdl or
http://www.w3.org/TR/soap12-part0/.

Siehe dazu auch unser Anwendungsszenario Filiafinder.

Warum bieten Sie für ebaas distance 2 Spezifikationen an: XML-RPC und Soap/WSDL?


Wir möchten Ihnen bei der Integration unseres Web-Service möglichst viele Freiheitsgrade bieten. Deshalb können Sie wählen, ob Sie Ihre Umkreissuche per XML-RPC oder SOAP/WSDL realisieren.
Mit Ihren Zugangsdaten können Sie beide Spezifikationen nutzen!
Entscheidungshilfe:
Beide Varianten liefern die selben Ergebnisse! Für welche Sie sich entscheiden, ist Ihnen überlassen. Allgemein lässt sich sagen: XML-RPC hat eine einfache Struktur und erzeugt damit weniger Overhead (schnellere Datenübertragung). SOAP/WSDL hat sich als Quasi-Standard für Web-Services durchgesetzt.

Siehe dazu auch unser Anwendungsszenario Filiafinder.

Welche Voraussetzungen sind notwendig, um ebaas distance in eine Web-Applikation zu integrieren?

ebaas distance bietet 2 Schnittstellen, die Sie für Funktionsaufrufe nutzen können. Ihre Applikation, z.B. Internetseite sendet eine Anfrage (etwa PLZ) per XML-RPC oder SOAP/WSDL an unseren Web-Service. Sie erhalten die gewünschten Daten (etwa PLZ im Umkreis mit Entfernungen) zurückgeliefert. Die beiden Schnittstellen liefern die gleichen Ergebnisse, unterscheiden sich aber in der technischen Umsetzung.

Sie wollen die XML-RPC-Schnittstelle nutzen:
Das für ebaas distance verwendete Protokoll XML-RPC ist sprachunabhängig, d.h. Sie können Funktionen auf unserem Server mit beliebigen Sprachen wie Java, Perl, PHP, ASP und weiteren aufrufen. Sie benötigen lediglich eine XML-RPC-Bibliothek, die Sie in Ihre Skripte einbinden.
Eine Übersicht verfügbarer XML-RPC-Bibliotheken für verschiedene Programmiersprachen finden Sie unter:
http://xmlrpc.scripting.com/directory/1568/implementations

 Dokumentation ebaas distance - XML-RPC

Sie wollen die SOAP/WSDL-Schnittstelle nutzen:
WSDL (Web Services Description Language) definiert eine plattform-, programmiersprachen- und protokollunabhängige XML-Spezifikation zur Beschreibung von Web Services.
Um die WSDL-Spezifikation von ebaas distance zu nutzen, können Sie beispielsweise das Protokoll SOAP verwenden. Unabhängig von Betriebsystem oder Programmiersprache verwenden Sie dann die verschiendenen Funktionen von ebaas distance. Ihr Client-Server benutzt also unsere WSDL Datei um mit unserem Server zu kommunizieren. Sie bekommen eine ausführliche Beschreibung dieser WSDL-Datei unter soap_server.php. Alles was sie jetzt noch machen müssen, ist eine Bibliothek oder eine Extension in ihr Applikationen einzubinden und dieses WSDL-File aufrufen. Wenn Sie z.B. das .NET Framework benutzen wollen, bieten wir Ihnen eine von uns erzeugte dll-Datei an, welche sie nur in Ihre Applikationen einbinden müssen. Wenn sie PHP verwenden, können Sie zum Beispiel nusoap oder Pear:soap Bibliotheken einbinden. Für weitere informationen:
http://pear.php.net/package/SOAP
http://dietrich.ganx4.com/nusoap/
http://msdn.microsoft.com

 Dokumentation ebaas distance SOAP/WSDL

--> Entscheidungshilfe für beide Varianten

Haben Sie Integrationsbeispiele für den Web-Service ebaas distance?

Wir stellen Ihnen Beispiele zur Integration unseres Web-Dienstes für die Server-Script-Sprachen: PHP (XML-RPC, SOAP/WSDL) und ASP XML-RPC, ASP.net SOAP/WSDL zur Verfügung.
Sollten Sie Hilfe bei der Integration benötigen, nehmen Sie bitte Kontakt mit uns auf, damit wir Ihnen ein Angebot unterbreiten können.

Unterstützen Sie bei der Integration von ebaas distance in Web-Applikationen?

Unsere Dokumentation ebaas distance - XML-RPC / Dokumentation ebaas distance - SOAP/WSDL sowie die Integrationsbeispiele für ebaas distance ermöglichen Internet-Agenturen eine zügige Implementierung von ebaas distance. Auf Wunsch unterstützen wir Sie gerne. Nehmen Sie bitte Kontakt mit uns auf, damit wir Ihnen ein Angebot unterbreiten können.

Welche Parameter beeinflussen die Umkreissuche?

Gerne passen wir ebaas distance Ihren Wünschen an! Nehmen Sie bitte Kontakt mit uns auf, damit wir Ihnen ein Angebot unterbreiten können.

Kann man auch über die Eingabe eines Ortsnamens suchen?

Ja. Die Funktion ebaasDistance.getPlaces liefert zu einem eingegebenen Ort und/oder Teilort (bzw. Wortbestandteil) und/oder PLZ alle übereinstimmenden PLZ-Ort-Kombinationen, die der Eingabe entsprechen. Nachfolgend kann man mit der Funktion ebaasDistance.showRelated oder ebaasDistance.showRelatedZip die Umkreissuche starten.
Überzeugen Sie sich von der exzellenten Trefferquote in unserem Onlinetest.

Wie genau werden die Entfernungen angegeben?

Die Angabe der Entfernungen zwischen Ausgangsort und ermittelten Orten im Umkreis erfolgt als Luftlinie in Kilometern und ist daher nur als ungefähre Größe zu verstehen.
Die Funktion ebaasDistance.showRelated ermittelt die exakte Entfernung zu Orten. Die gleiche PLZ kann hier mehrfach mit unterschiedlichen Entfernungen zurückgeliefert werden.

Zur Veranschaulichung:

Entfernung zwischen 2 Postleitzahlen als Luftlinie in KM zwischen den Mittelpunkten der PLZ-Gebiete, die durch ein Polygon beschrieben werden. Jedes (Zustell)Postleitzahlgebiet hat die Form eines Polygon.
Die Entfernung (Luftlinie) zwischen zwei PLZ-Gebieten entspricht dem Abstand der Mittelpunkte (M1 und M2) dieser Polygone (PLZ-Gebiete). Ein Mittelpunkt wird durch ein das Polygon umlaufendes Rechteck ermittelt.

Wie unterscheiden sich die einzelnen Funktionen (Methoden) von ebaas distance?

ebaasDistance.getPlaces: Die Funktion dient dazu, anhand der Nutzereingabe eine genaue Ortbestimmung durchzuführen. Der Vorteil hier liegt in der hohen Toleranz gegenüber der Eingabe. Die exkate Bestimmung des Ausgangsortes wird mit dieser Funktion erheblich erleichtert.
Nach Eingabe eines Ortsnamen (oder Wortbestandteiles davon) und/oder einer Zustell-PLZ werden alle gefundenen Orte mit Postleitzahlen zurückgegeben (-> mehrere Orte passen zur Eingabe und/oder ein Ort besitzt mehrere PLZ).
Anhand des Parameters locid kann man dann die Umkreissuche / Entfernungsberechnung über die Funktion ebaasDistance.showRelated oder ebaasDistance.showRelatedZip starten.

ebaasDistance.showRelated: Die eigentliche Funktion zur Umkreissuche bzw. Entfernungsberechnung. Nach Eingabe einer Postleitzahl werden im definierten Umkreis alle PLZ-Ort-Kombinationen mit Entfernung zum Ausgangsort zurückgegeben (Luftlinie in km). Existieren zu einer PLZ mehrere Orte, wird zur Entfernungsberechnung der geographische Mittelpunkt dieser Ortschaften benutzt. In diesem Fall erhält man eine exakte Entfernungsberechnung, indem man zuvor die Funktion ebaasDistance.getPlaces aufruft und eine genaue Ortsbestimmung über den Parameter locid erhält. Dieses Vorgehen sehen Sie auch bei unserem Online-Test Umkreissuche.

ebaasDistance.showRelatedZip: Weitere Funktion zur Umkreissuche / Entfernungsberechnung. Hier bekommen Sie allerding "nur" Postleitzahlen und Entfernungen zurückgeliefert.
Vorteil: Höhere Performance, da weniger Daten per XML an Ihren Server zurückgeliefert werden. Es kann ein größerer Suchradius als bei ebaasDistance.showRelated verwendet werden (ca. 1,5 Sekunden zur Übermittlung der Daten an Ihren Server bei 100 km Radius).
Weiterhin können Sie z.B. Entfernungen zwischen 2 oder mehreren PLZ bestimmen. Hierzu übergeben Sie z.B. als Parametern an ebaas distance: zip als Ausgang-Postleitzahl, sowie im optionalen Parameter ziplist ein Array aus einer oder mehreren Ziel-Postleitzahl(en) ; der Radius sollte entsprechend hoch gewählt werden, z.B. 1000.
Existieren zu einer PLZ mehrere Orte, wird zur Entfernungsberechnung der geographische Mittelpunkt dieser Ortschaften bestimmt (Postleitzahl-Gebiet) und die Entfernung (Luftlinie in km) zur Ausgangs-PLZ zip berechnet.
Dieses Vorgehen sehen Sie auch bei unserem Online-Test Umkreissuche-PLZ.

ebaasDistance.showRelatedLoc: Weitere Funktion zur Umkreissuche / Entfernungsberechnung. Ähnlich wie ebaasDistance.showRelatedZip. Mit folgenden Abweichungen:
Die Funktion arbeitet länderübergreifend.
Die Funktion benutzt zur Berechnung abweichend zu ebaasDistance.showRelatedZip die ID von Ausgangsort bzw. einem oder mehreren Zielorten. Damit arbeitet diese Funktion genauer.
Um die eindeutigen ID's von Ausgangsort (und evtl. Zielorten) zu übergeben, ist es zwingend erforderlich, zuvor die Funktion ebaasDistance.getPlaces aufzurufen.
Zur Entfernungsberechnung zwischen 2 oder mehr Orten übergeben Sie z.B. als Parametern an ebaas distance: locid als Ausgangsort, sowie im optionalen Parameter loclist ein Array aus einer oder mehreren Land-ID-Kombinationen (Array) ; der Radius sollte entsprechend hoch gewählt werden, z.B. 1000 oder größer.
Dieses Vorgehen sehen Sie auch bei unserem Online-Test Entfernungsberechnung.

In welchen Ländern ist eine Umkreissuche möglich?

Die aktuelle Version von ebaas distance unterstützt die Umkreissuche für ganz Europa. Hier erhalten Sie weitere Informationen zu den Ländern.

Kann man ebaas distance zu Testzwecken in eine Web-Applikation integrieren, bevor man eine Lizenz erwirbt?

Ja. Sie können unseren Web-Service kostenlos zu Testzwecken in eine Web-Applikation einbinden. So können Sie unseren Dienst prüfen, bevor Sie sich für eine kostenpflichtige Lizenz entscheiden.
Nehmen Sie unser faires Angebot an und bestellen Ihren kostenlosen Testzugang.

Mein Testzugang ist abgelaufen. Kann ich diesen in eine kostenpflichtige Lizenz umwandeln?

Unser faires Angebot hat Sie überzeugt? Dann erwerben Sie hier Ihre kostenpflichtige Lizenz. Sie erhalten neue Zugangsdaten.

Was muss ich tun, um ebaas distance in meine Seiten zu integrieren?

  1. Lizenz erwerben oder kostenlosen Testzugang bestellen.
  2. Bei der Anmeldung teilen Sie uns die IP-Adresse Ihres Servers mit, auf dem ebaas distance integriert werden soll (nur für Lizenz!).
  3. Sie erhalten Ihre Zugangsdaten per Email.
  4. Die zugeteilte Kundennummer (customer_id) verwenden Sie im Funktionsaufruf von ebaas distance.
    • Kostenpflichtige Lizenz: Zusammen mit der festgelegten IP-Adresse stellen wir sicher, daß Ihre Lizenz nicht unberechtigt verwendet wird.
    • Kostenloser Test-Zugang: Integrieren Sie ebenfalls Ihr Passwort (password) in den Funktionsaufruf von ebaas distance (Bei Lizenz nicht erforderlich!).
  5. Die Auswertung der Ergebnismenge, die die Funktionen von ebaas distance zurückliefern, liegt ganz in Ihrer Hand.

Referenzen

  • Willi Schillig Polstermöbelwerke GmbH & Co. KG

      Weitere Informationen finden Sie
    unter www.schillig.com.
     
  • Arco Polstermöbel GmbH & Co. KG

      Weitere Informationen finden Sie
    unter www.arco-polstermoebel.de.