BATCH-Jobs
Einleitung
Mit Hilfe des Batch-Jobs ist es möglich eine große Anzahl Karten zu erzeugen, ohne eine ständige Verbindung zum Server zu halten. Das Geocoden der Adressen, das Routing der Ziele, sowie die Erzeugung der Karten erfolgt parallelisiert, damit wird eine schnelle Batch-Job-Abwicklung erreicht! Das Verwenden des Batch-Jobs bei einer größeren Kartenanzahl ist sinnvoll.
Der Batch-Job ermöglicht es 2 Arten von Karten zu erzeugen, die locr NAVImaps (Routenkarten) und die locr LOCALmaps (Umgebungskarten). Bei den LOCALmaps wird nur eine Adressdatei (customer) benötigt, während bei den NAVImaps aufgrund der Routendarstellung 2 Adressdateien (customer/shop) erwartet werden.
Voraussetzungen
Um einen Batch-Job zur automatischen Erzeugung von Karten zu starten, gibt es 2 Voraussetzungen.
1. Einen Benutzernamen und ein Passwort zum Verwenden des Dienstes.
Die Zugangsdaten erhalten sie von Ihrem Partner oder direkt von locr.
Um sich mit dem Server zu verbinden ist eine Authentifizierung nötig, die hier beschreiben wird:
2. Und die Vorgabe des zu verwendenden Servers, z.B.: http://maps1.locr.com
Start eines Batch-Jobs
Um einen Batch-Job zu starten sind folgende 3 Schritte nötig:
Datenimport/Batch-Job anlegen:
Zum Anlegen eines Batch-Jobs muss man zuerst die zu verarbeitenden Daten hochladen.
Dazu schickt man einen POST-Request mit dem enctype "multipart/form-data", z.B. an folgende Adresse:
https://maps1.locr.com/batch-processing/job.php?action=init&name=<jobname>
Da beim Anlegen eines Batch-Jobs eine Default-Konfiguration geladen wird, die nachträglich geändert werden kann, ist es möglich den Batch-Job sofort zu starten.
Zum Anstarten eines Batch-Jobs muss folgende Adresse mit der entsprechenden RequestId aufrufen werden:
https://maps1.locr.com/batch-processing/job.php?action=start&name=<jobname>&to_dos=geocoding,routing
Zum Runterladen der Daten muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/job.php?action=download&request_id=<RequestId>
Weitere Funktionen:
Batch-Job Konfiguration anpassen:
Um Konfigurationseinstellungen für den Batch-Job zu ändern, muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/job.php?action=configure&request_id=<RequestId>
Statusabfrage eines Batch-Jobs:
Zur Statusabfrage eines Batch-Jobs muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/status.php?action=status&name=<jobname>&to_dos=geocoding
Zum Abbrechen eines laufenden Batch-Jobs muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/job.php?action=cancel&name=<jobname>
Zum Zurücksetzen eines Batch-Jobs muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/job.php?action=reset&name=<jobname>&to_dos=geocoding,routing,map_creation
Zum Löschen eines Batch-Jobs muss man folgende Adresse mit der entsprechenden RequestId aufrufen:
https://maps1.locr.com/batch-processing/job.php?action=remove&name=<jobname>