Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Routing.rst file and images, to document the Routing element #514

Open
wants to merge 6 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions de/elements/search.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ Suchen

search/search_router.rst
search/simplesearch.rst
search/routing.rst
68 changes: 68 additions & 0 deletions de/elements/search/routing.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
.. _routing_de:

Routing
*******

Das Routing-Element fügt einer Anwendung ein Streckenführung-Werkzeug hinzu. Nach Angabe von Start, Ziel und ggf. Zwischenpunkten wird eine geeignete Streckenführung in der Karte angezeigt. Zusätzlich können Informationen zur Strecke ausgegeben werden.

.. image:: ../../../figures/de/routing.png
:scale: 70


Konfiguration
=============

.. image:: ../../../figures/de/routing_configuration.png
:scale: 70

* **Erweiterte Einstellung:** Ermöglicht es weitere Einstellungen vorzunehmen (Standard: false).
* **Titel:** Titel des Elements.
* **Route direkt ausgeben:** Konfiguration zum Deaktivieren/Aktivieren des automatischen Routings ohne Interaktion des Nutzers (Standard: false).
* **Zwischenpunkte erlauben:** Konfiguration zum Deaktivieren/Aktivieren der Zwischenpunkten (Standard: false).
* **Suche aktivieren:** Konfiguration zum Deaktivieren/Aktivieren der Suchoption (Standard: false).
* **Geokodierung aktivieren:** Konfiguration zum Deaktivieren/Aktivieren der Geokodierung (Standard: false).
* **Zoompuffer(m):** Definition eines Zoompuffers für die Ergebnisanzeige in Meter (Standard: 0).
* **Linienfarbe:** Anpassen der Lineinfarbe und Deckkraft per rgba Standard (Standard: rgba(66, 134, 244, 1)).
* **Linienbreite:** Anpassen der Linienbreite (Standard: 3).
* **Infotext zur Route:** Option einen Infotext zur Route zu implementieren (Standard: {start} → {destination} </br> {length} will take {time}).
* **Zeitformat:** Anpassen des Zeitformats (Standard: ms).

.. image:: ../../../figures/de/routing_configuration_icons.png
:scale: 70

* **Pfad Starticon:** Anpassen des Starticons (Standard: /bundles/mapbenderrouting/image/start.png).
* **Pfad Zwischenicon:** Anpassen des Zwischenicons.
* **Pfad Zielicon:** Anpassen des Zielicons (Standard: /bundles/mapbenderrouting/image/destination.png).
* **Größe Icons:** Die Größe der verschiedenen Icons ist anpassbar.
* **Offset icons:** Das Offset der verschiedenen Icons ist anpassbar.

.. image:: ../../../figures/de/routing_configuration_service.png
:scale: 70

* **Routingsoftware:** Auswählen der Routingsoftware (OSRM, GraphHopper, PgRouting, Trias).
* **URL:** Setzen der URL-Adresse für die Routingsoftware.
* **Services:** Auswahl aus verschiedenen Services (Route, matrix, Rundreise, Mapbox Vector Tiles, nächste, übereinstimmen).
* **Transportmodus:** Auswählen der Routing-Profile (Auto, Fahhrad, Füßgänger). Auch die Auswahl mehrerer ist möglich.
* **API-Version:** Version der API bestimmen.
* **Wegbeschreibung ausgeben:** Auswählen ob es eine Wegbeschreibung geben soll oder nicht (Standard: false).

.. image:: ../../../figures/de/routing_configuration_search.png
:scale: 87

* **Suchsoftware:** Auswählen des Such-Dienstes (derzeit nur Solr).
* **Query URL:** Setzen der URL-Adresse für die Suchsoftware (Solr).
* **Query URL-Parameter:** Der Suchparameterschlüssel, der angehängt wird (z.B. q).
* **Query Whitespace Ersetzung:** Setzen von Paramteren zum Ersetzung im Such-Therm.
* **Query Key Format:** Setzen des Such-Formats (Im diesem SimpleSearch Format Beispiel: %s).
* **Tokenizer Split/Such/Ersetzungs-Regex:** Setzen von RegexFormat-Teilungsmuster/-Suchmuster/-Ersetzungsparameter(Standard: false).
* **Pfas zu den Ergebnissen:** Setzen des Pfads, der vom Abfrageergebnis extrahiert wird (Standard: response.docs).
* **Attribut für Beschriftung:** Attribut oder mehrere Attribute , die als Ergebnis angezeigt werden sollen.
* **Attributname für Geometrie:** Attributname der Geometrie (z.B. wgs84).
* **Geometrieformat:** Geometrieformat, kann WKT oder GeoJSON sein (z.B. WKT).
* **Quell-SRS:** EPSG-Code des primären Koordinatenbezugsystems (z.B. EPSG:4326).


YAML-Definition
---------------


1 change: 1 addition & 0 deletions en/elements/search.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ Search

search/search_router.rst
search/simplesearch.rst
search/routing.rst
68 changes: 68 additions & 0 deletions en/elements/search/routing.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
.. _routing:

Routing
*******

The routing element adds a routing tool to an application. After specifying the start, destination and any intermediate points, a suitable route is displayed on the map. Information about the route can also be displayed.

.. image:: ../../../figures/de/routing.png
:scale: 70

Configuration
=============


.. image:: ../../../figures/routing_configuration.png
:scale: 70

* **Advanced route settings:** Allows you to make further settings.
* **Title:** Elements Title.
* **Route immediately:** Configuration to deactivate/activate automatic routing without the users interaction (default: false).
* **Allow intermediate points:** Configuration for deactivating/activating intermediate points (default: false).
* **Enable Search:** Configuration to deactivate/activate the search option (default: false).
* **Reverse Geocoding:**
* **Zoom buffer (m):** Definition of a zoom buffer for the result display in meters (default: 0).
* **Line color:** Option to adjust the line color and opacity with the rgba standard (default: rgba(66, 134, 244, 1)).
* **Line width:** Option to adjust the line width (default: 3).
* **Route info text:** Option to add an info text for the rout (default: {start} → {destination} </br> {length} will take {time}).
* **Time output format:** Adjust the time format (default: ms).

.. image:: ../../../figures/routing_configuration_icons.png
:scale: 70

* **Path start icon:** Customize the start icon (default: /bundles/mapbenderrouting/image/start.png).
* **Path intermediate icon:** Customize the intermediate icon
* **Path destination icon:** Customize the destination icon (default: /bundles/mapbenderrouting/image/destination.png).
* **Size Icon:** Adjust the size of the different icons.
* **Offset Icon:** Adjust the offset of the different icons.

.. image:: ../../../figures/routing_configuration_service.png
:scale: 70

* **Routing software:** Select the routing software (OSRM, GraphHopper, PgRouting, Trias).
* **URL:** Set the URL address for the routing software.
* **Services:** Select from various services (route, matrix, round trip, Mapbox Vector Tiles, next, match).
* **Transportation mode:** Select the routing profiles (car, bicycle, pedestrian). It is also possible to select more than one.
* **API-Version:** Determine the version of the API.
* **Route description:** Select whether there should be a route description or not (default: no).

.. image:: ../../../figures/routing_configuration_search.png
:scale: 87

* **Search software:** Select the search service (currently only Solr).
* **Search URL:** Set the URL address for the search software (Solr).
* **Search parameter key:** Set the search parameter key.
* **Whitespace replacement pattern:** Set parameters to replace the search term.
* **Search format:** Set the search format (in this example the SimpleSearch format is: %s).
* **Tokenizer split/search/replace:** Set RegexFormat-split pattern/search pattern/replacement parameter (default: false).
* **Collection path:** Set the attribute path that is extracted from the query result (default: response.docs).
* **Label attribute:** Name of the attribute's to show as result.
* **Geom attribute:** Name of the geometry attribute (e.g. wgs84).
* **Geom format:** Geometry data format, can be WKT or GeoJSON (e.g. WKT).
* **Projection Geom:** EPSG code of the spatial reference system(e.g. EPSG:4326).



YAML-Definition
---------------

Binary file added figures/de/routing.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/de/routing_configuration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/de/routing_configuration_icons.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/de/routing_configuration_search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/de/routing_configuration_service.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/routing_configuration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/routing_configuration_icons.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/routing_configuration_search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added figures/routing_configuration_service.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.