Hintergrund

Diese Schnittstelle soll einige unserer Anwendungen mit Daten versorgen. Die Daten werden als JSON ausgegeben

Letzte Änderung

6.nov.2013

Suche nach dem größten Ort innerhalb eines Polygons

/geo?loc=49.0,11.0 50.0,11.0 50.0,12 49,12&zoom=2&plz=1

Es wird immer nur ein Ort zurückgegeben.
Dieser Aufruf klappt nur für Postleitzahlen, weil nur dafür sind Einwohnerzahlen vorhanden.

Nutzung der Schnittstelle

Geografische Namen, Orte und Koordinaten

Anfragen zu Ortsnamen kann man mit oder ohne Postleitzahl machen.
Der Aufruf hat die Adresse http://api.cross-solution.de/geo

Folgende Parameter sind möglich

q

Suchanfrage über Name, die Suchanfrage muß als URI codiert werden

loc

Anfrage über Koordinate, die Koordinate muß die Form haben [+-]Zahl.Zahl,[+-]Zahl.Zahl
Es wird eine Liste mit Ergebnissen zurückgegeben in der Reihenfolge der naheliegensten Einträge.
In Kombination mit dem Parameter plz=1 wird die Suche eingeschränkt auf Ort mit eingetragener Postleitzahl.
Bei strict=1 wird nur ein Ergebnis zurückgegeben.

plz

0 = es werden alle Ergebnisse zurückgegeben (default)
1 = es werden nur Ergebnisse mit Postleitzahl zurückgegeben
gibt man in der Suchanfrage eine Postleitzahl an, so werden auch im Default Ergebnisse mit Postleitzahl bevorzugt, was nicht bedeutet daß Ergebnisse ohne Postleitzahl komplett ausgeschlossen werden

zoom

0 = es werden nur die Ortsnamen zurückgegeben
1 = es werden Ortsnamen und Bundesland zurückgegeben (default)
Hinweis zum Suchstring, bei einer Suche, die das Bundesland mit einschliessen soll, muß zoom=1 sein.

country

Eine kommagetrennte Liste von Landesbezeichnungen, zB "DE" (default) oder "DE,AT,CH"

strict

0 = es werden alle Ergebnisse zurückgegeben, die eine größtmögliche Ähnlichkeit zu dem Suchbegriff haben (default)
1 = der Suchbegriff muß vollständig mit dem Städtenamen übereinstimmen

coor

0 = das Ergebnis sind die Ortsnamen
1 = das Ergebnis sind die Koordinaten
2 = das Ergebnis sind die Koordinaten oder ein Polygon, Polygone sind mehrere Koordinaten, getrennt durch ein Leerzeichen.^[1]

user

Benutzername, ist im Default leer

version

Versionsnummer, ist im Default immer die aktuelle Version

Beispiel:
http://api.cross-solution.de/geo?q=Neustadt+Bayern&zoom=1
Ergebnis:
- Neustadt bei Coburg, Bayern
- Neustadt an der Waldnaab, Bayern
- Neustadt an der Donau, Bayern
- Neustadt an der Aisch, Bayern
- Neustadt am Main, Bayern
- Bad Neustadt an der Saale, Bayern
- Zwölfling, Bayern
- Zwölfhäuser, Bayern
- Zwirkenberg, Bayern
- Zwieslerwaldhaus, Bayern
- Zwieslerbruck, Bayern
- Zwiesele, Bayern
- Zwieselberg, Bayern
- Zwiesel, Bayern
- Zwiefelhof, Bayern

Beispiel:
http://api.cross-solution.de/geo?loc=52.3475,14.5539&zoom=1&plz=1
Ergebnis:
- 03172 Pinnow-Heideland, Brandenburg
- 03172 Lutzketal, Brandenburg
- 03172 Guben, Brandenburg
- 03172 Bärenklau, Brandenburg
- 03172 Atterwasch, Brandenburg
- 03172 Grabko, Brandenburg
- 03197 Drewitz, Brandenburg
- 03172 Gastrose-Kerkwitz, Brandenburg
- 03185 Tauer, Brandenburg
- 03197 Jänschwalde, Brandenburg
- 03185 Peitz, Brandenburg
- 03185 Turnow-Preilack, Brandenburg
- 03172 Grießen, Brandenburg
- 03185 Drachhausen, Brandenburg
- 03185 Drehnow, Brandenburg

Beispiel:
http://api.cross-solution.de/geo?q=35091+Cölbe&coor=1&strict=1
Ergebnis:
- 50.85,8.8

Anmerkung [1] Verwendung bei Solr:

1. Das Ergebnis der Anfrage http://weitz.api.xenon/geo?q=hessen&coor=2 hat die Form
   {"result":["51.60746,9.43245 51.56619,9.59347 51.36667,9.76667 51.32494,9.91545 51.18206,10.17283 51.03579,10.18111 ,8.82679 51.5096,8.99849"]}
   d.h. ein Koordinatenpaar ist getrennt durch ein Leerzeichen, die beiden Koordinaten sind getrennt durch ein Komma.
   Bei Solr ist es genau umgekehrt, dort sind Koordinatenpaare getrennt durch ein Komma und die Koordinate selber durch ein Leerzeichen.
   
2. Bei Solr muß die erste Koordinate identisch sein zur letzten, dh, das erste Koordinaten-Paar muß hinter das letzte Koordinatenpaar angehängt werden
   
3. Die Koordinaten im Polygon sind im Format Latitude-Longitude - entsprechend der Verwendung bei allen anderen Angaben, und auch für den Normalfall bei Solr.
   Bei den Polygonen (und nur da) weicht Solr aber von diesem Format ab und verwendet die Longitude-Latitude Schreibweise.
   Also hier jedes Koordinatenpaar drehen.