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:

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