Batch-Job Konfiguration

Abfrage der aktuellen Konfiguration:

Beim Anlegen eines Batch-Jobs wird eine Default Konfiguration eingefügt, diese kann mit folgenden Parametern angepasst werden. 

Um die Konfigurationseinstellungen für den Batch-Job anzuzeigen, muss folgende Adresse mit der entsprechenden Request-Id oder dem Batch-Job-Namen aufgerufen werden: 

action=configure

Bsp.:

https://maps1.locr.com/batch-processing/job_v2.php?action=configure&request_id=<RequestId>

Ändern der aktuellen Konfiguration:

Um die Konfiguration zu ändern, müssen die entsprechenden Parameter übermittelt werden.

Geocoding:

Alle Adressen werden geocodiert, dabei wird eine Position (Latitude/Longitude) in der Datenbank eingetragen. Zusätzlich bekommt jede Position eine Genauigkeitsstufe zugeteilt, dies ist das Qualitätsmerkmal der Adressen, also wie genau die Position mit der angegebenen Adresse übereinstimmt.

Es gibt 6 Stufen:

Je nach vorgebenen Werte werden nur die Adressen für das Projekt verwendet, die einen höheren Qualitätswerte haben , das der eingestellte!

Die Default Einstellungen sind Postal für Kundenadressen und Hausgenauigkeit für Zieladressen!

Bsp.:

https://batch.locr.com/job_v2.php?action=configure&request_id=<request_id>&min_customer_accuracy_to_use=<accuracy>&min_shop_accuracy_to_use=<accuracy>

<accuracy>-Werte: 10 (manual), 8 (house), 6 (street), 5 (postal), 4 (city)

Routing

Art des Routings festlegen:

Beim Routing kann festgelegt werden mit welcher Art das Routing durchgeführt werden soll, z.B. die schnellste oder die kürzeste Route

routing_type=<F/E/S/N/A/I/M/P>

Mögliche Werte: 

Bsp.:

https://maps1.locr.com/batch-processing/job_v2.php?action=configure&request_id=<RequestId>&routing_type=F

Anzahl der Routen bei NAVImaps festlegen (max. 5): (default: 1)

Auf einer Karten können bis zu 5 Routen eingezeichnet werden.

routing_max_shops_count=<1-5>

Max. Entfernung: (default: ∞)

Angabe der max. Entfernung in der Ziele zugeordnet werden sollen.

routing_max_shops_distance=<int>

Einheitsangabe: (default: m)

Einheit in der die Entfernung angegeben wird.

routing_max_shops_distance_unit=<m|km|mi|ft>

Kartendarstellung

Kartengröße

Bei Festlegung der Kartengröße kann die Einheit "cm, inch, Pixel" und dann die eigentliche Größe festgelegt werden.

Map size:

Map unit:

Border:

Darstellung einer Route (Farbe/Breite/Transparanz)

Auswahl von Icons (Start/Ziel)

Größe eines Icons (Start/Ziel)

<value> kann dabei ein Integer-Wert sein, der relativ zur Kartengröße angepasst wird. Default ist "0"! Beispiel: -2, 3, 5.

<value> kann prozentualer Wert von 1% bis 100% sein. Default ist "100%"!

Wenn ein Prozentualer Wert übergeben wird muss das %-Zeichen url-encoded sein: Beispiel für "90%" => "90%25".

Bsp.:

https://maps1.locr.com/batch-processing/job_v2.php?request_id=<RequestId>&action=configure&shop_icon_name=flag1&shop_icon_color=BL&shop_icon_type=type2

Beispielrückgabe einer Konfiguration

<?xml version="1.0" encoding="utf-8"?>

<BatchProcessing>

    <Response>

        <MetaInfo>

            <RequestId>4fec2eb23a16880b77000000</RequestId>

            <Name>jobname</Name>

            <Created>2012-06-01 12:00:00</Created>

        </MetaInfo>

        <Configuration>

            <Geocoder>

                <tolerance>normal</tolerance>

                <min_accuracy/>

                <postal_accuracy/>

            </Geocoder>

            <Router>

                <type>F</type>

                <color>BK</color>

                <width>5</width>

            </Router>

            <Maps>

                <config>1</config>

                <size_width>14.8</size_width>

                <size_height>10.5</size_height>

                <size_unit>cm</size_unit>

                <icons>

                    <customer>

                        <I>pin1</I>

                        <C>BL</C>

                    </customer>

                    <shop>

                        <I>button1</I>

                        <C>AQ</C>

                    </shop>

                </icons>

                <border>

                    <top>0.125</top>

                    <right>0.125</right>

                    <bottom>0.125</bottom>

                    <left>0.125</left>

                </border>

            </Maps>

        </Configuration>

    </Response>

</BatchProcessing>