Neuerungen zum 1. Juli 2008

Da sich unser Webserice immer größerer Beliebtheit erfreut und bisher leider wenig bis keine Kontrolle über eventuell mißbräuchliche Nutzung des Dienstes möglich war, muss ab dem 1. Juli 2008 ein Nutzer-Schlüssel mit der Anfrage übergeben werden.
Nicht-kommerzielle Webseiten erhalten diesen Schlüssel selbstverständlich kostenfrei.
Bitte schreiben Sie unter Angabe Ihres Domainnamens und der IP-Adresse eine E-Mail an support@umkreis.net.
Etwaige Unannehmlichkeiten durch die Umstellung bitten wir zu entschuldigen, aber nur durch diese Maßnahme sehen wir uns in der Lage, den Service aufrecht zu erhalten und bitten um Verständnis.

umkreis.net - Umkreissuche "for the rest of us"

• Keine Software-Installation auf Ihrem Server
• Kein Umbau der bestehenden Suchabfragen
• Leichte Integration in bestehende Systeme
• Kostenfrei für nichtkommerzielle Seiten und für weniger als 5.000 Anfragen/Monat

Zu hunderten werden im Internet Suchformulare angeboten, in denen der Besucher der Webseite z. B. Filialen eines großen Unternehmens in seiner Nähe finden kann. Wenn es dabei die Möglichkeit gibt, in der Umgegend des Standortes zu suchen, greifen die Webseitenbetreiber oft auf teure Web-Services großer Kartenanbieter zu.

In vielen Fällen reicht aber schon eine einfache Suche aus, welche die Filial-Standorte im Umkreis einer Postleitzahl aus einer Datentabelle herausfiltert. umkreis.net bietet Ihnen als Webseitenbetreiber einen denkbar einfach zur Integrtation von Umkreissuchen.

Das Problem

Sie haben auf Ihrem Server folgende Tabelle mit dem Namen "Adressen" liegen:

Ihre bisherige SQL-Abfrage sah vielleicht so aus:

SELECT * FROM Adressen WHERE Sortiment LIKE '%farbe%';

mit dem Ergebnis

Dabei kommt die Anfrage von einer Person aus 55777 Fohren-Linden, nur ca. 8km von Blaubach entfernt, aber über 300km entfernt von Bischofsgrün. An diesem Beispiel wird deutlich, dass auch eine Suche nach einer Postleitzahl des gleichen Nummernkreises kein Ergebnis gebracht hätte.

Die Lösung

Sie können jetzt Ihre SQL-Abfrage von oben an unseren WebService senden. Dabei übergeben Sie per GET außerdem das PLZ-Gebiet, um das herum gesucht werden soll (z. B. 55777), den Namen der Spalte, die die PLZ enthält ("PLZ") und den Radius, in dem gesucht werden soll.

http://www.umkreis.net/webService/uks?query=SELECT+%2A+FROM+Adressen+WHERE+Sortiment+LIKE+%27%25farbe%25%27&radius=30&plzField=PLZ&plz=55777

Das folgende Beispiel zeigt, wie Sie den WebService mit PHP nutzen können:

<?php
    
    // KEY:         In Zukunft wird die Abfrage per WebService über einen
    //              Key reglementiert werden.
    define("UKS_KEY", "DUMMY");
    // PLZ_FIELD:   Name der Spalte, in der in der vorhandenen Datenbank
    //              die Postleitzahlen abgelegt sind.
    define("UKS_PLZ_FIELD", "PLZ");
    // DIST_NAME:   Dem Result-Set wird eine Spalte hinzugefügt, die die
    //              Distanz zur übergebenen PLZ enthält. Der Name lässt
    //              sich ändern, um Doppelbenennungen zu vermeiden.
    define("UKS_DIST_NAME", "dist");
    // SHOW_DIST:   Die Abfrage kann kürzer und schneller werden, wenn
    //              die Distanz nicht ausgwertet werden soll.
    define("UKS_SHOW_DIST", true);
    // DEBUG:       Gibt Fehlermeldungen zurück wenn true, sonst liefert
    //              die Funktion als Ergebnis false.
    define("UKS_DEBUG", false);
    
    // Diese Funktione erleichtert die Abfrage des WebService. 
    function uksQuery($query, $plz, $radius) {
        $url = "http://www.umkreis.net/webService/uks?"
        ."&query=".urlencode($query)
        ."&radius=".$radius
        ."&plzField=".UKS_PLZ_FIELD
        ."&distName=".UKS_DIST_NAME
        ."&plz=".$plz
        ."&key=".urlencode(UKS_KEY);
        
        $uksQuery = file_get_contents($url);
        if (strstr($uksQuery, "ERROR")) {
            if(UKS_DEBUG) {
                print $uksQuery;
            }
            return false;
        } else {
            return $uksQuery;
        }
    }
    
    $query = "SELECT * FROM Adressen WHERE Sortiment LIKE '%farbe%';";
    $plz = "55777";
    $radius = 30;
    $uksQuery = uksQuery($query, $plz, $radius);
?>

Die vom WebService neu berechnete SQL-Abfrage sieht für unser Beispiel dann so aus:

Damit wird folgendes Ergebnis für die Abfrage geliefert: