BATCH-Jobs‎ > ‎

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:
 10 manual            Position wurde manuell vorgegeben.
 8 house                Position entspricht der Adresse.
 6 street Position entspricht dem Mittelpunkt der angegebenen Straße.
 5 postal Position entspricht dem Mittelpunkt des angegebene Postleitzahlengebietes.
 4 city Position entspricht dem Mittelpunkt des angegebene Stadtnames, kommt ein Stadtnamen in einem Land häufiger vor, kann nicht garantiert werden, das dies die vorgebene Stadt ist. (Möglichst nicht verwenden!)
  
 Keine Position, da Adressen nicht gefunden wurde!

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: 
  • F (fast)  default
  • E (easy), S (short)
  • N (no freeways)
  • A (avoid freeways)
  • I (ignore pipes)
  • M (more freeways)
  • P (pedestrian)
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_size_width
  • map_size_height

    Oder als einzelner Parameter:  
  • map_size
    Example: 21x14.8 (Width + Height)

Map unit:

  • map_size_unit
    Mögliche Werte: px, cm (default), inch

Border:

  • map_border_left, map_border_right, map_border_top, map_border_bottom

Darstellung einer Route (Farbe/Breite/Transparanz)

  • routing_color
    Mögliche Werte: AQ, BK, BL, FU, GN, GR, LI, MR, NA, OL, PU, RD, SI, TE, WH, YE (default: BK)
    [Farbauswahl]

  • routing_width
    Mögliche Werte: 0-100 (default: 5)

  • routing_transparency
    Mögliche Werte: 0,20,40,60,80

Auswahl von Icons (Start/Ziel)

  • customer_icon_name

  • customer_icon_color
    Mögliche Werte: AQ, BK, BL, FU, GN, GR, LI, MR, NA, OL, PU, RD, SI, TE, WH, YE (default: BK) 
    [Farbauswahl]

  • shop_icon_name
    Beispiel: pin1 [Pinauswahl]

  • shop_icon_color
    Mögliche Werte: AQ, BK, BL, FU, GN, GR, LI, MR, NA, OL, PU, RD, SI, TE, WH, YE (default: BK) 
    [Farbauswahl]
  • shop_icon_type
    Dient zur Auswahl des richtigen Icons, wenn über die Angabe "shop_type" bei den Zieladressen, mehr als ein Icon vordefiniert wurde.

Größe eines Icons (Start/Ziel)

  • customer_icon_size=<value>
    shop_icon_size=<value>

<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>
Comments