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