locationfinder
==============

Mit der **LocationFinder**-Komponente kann ein externer LocationFinder-Dienst im
Viewer angebunden werden.

Konfiguration
-------------

Die URL des Dienstes muss in der Konfiguration überschrieben werden::

    locationfinder:
        url: "http://locationfinder.local/Finder/Lookup"
        limit: 10
        filter: ~

Der Parameter ``limit`` beschreibt die Anzahl der Ergebnisse, die dem Benutzer maximal angezeigt
werden. ``filter`` hingegen erlaubt die Filterung nach Land oder Typ.

Typen
-----

PlexMap unterstützt die Typen des LocationFinders, d.h. es kann nach Typ gruppiert, sortiert und
limitiert werden. Hierzu ist es empfohlen, ``limit`` z.B. auf 100 zu erhöhen, um sicherzustellen,
dass für jede Typkategorie Einträge zurückgegeben werden. ``filter`` sollte nicht gesetzt sein
(``~``).

Die Typen selber können über eine Liste von Typbezeichner und Namen (im Viewer) konfiguiert werden.
Hier ein Auszug der Standardkonfiguration, die überschrieben werden kann. Die Reihenfolge ist hier
für die Sortierung der Ergebnisse wichtig::

    locationfinder:
        types:
            - type: Straßenname
              name: Straßenname
            - type: Adresse
              name: Adresse
            - type: Gewann
              name: Gewann
            - type: Stadtbezirk
              name: Stadtbezirk
            (...)