Batch-Job Daten runterladen

n der Ergebnisse/Daten muss folgender HTTP-GET Aufruf mit der entsprechenden Request-Id oder dem Batch-Job-Namen erfolgen.

Ein Batch-Job kann aus 3 verschiedenen Aufgaben bestehen:

- Geocodieren der Adressen (geocoding)

- Zuordnen von Kundenadressen zu Zieladressen (routing)

- Kartenerstellung (map_creation)

Dementsprechend können auch die Ergebnisse zu den Batch-Jobs einzelnd oder komplett heruntergeladen werden.

Dies geschieht über den HTTP-GET-Aufruf mit der Batch-Job-Id und dazugehörigen Parametern:

action=download

Bsp.:

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

Als Ergebnis kommt eine komprimierte zip-Datei mit allen vorhandenen Daten zurück, die man lokal speichern kann.

Parameter zum Festlegen der Download-Daten:

download_only=<Parameter>

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

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

*HINWEIS: Es können alle Adressen kostenlos heruntergeladen werden! Nur für die zusätzliche Informationen Entfernung/Fahrzeit/Geocodes entstehen Zusatzkosten!

Zusätzliche Angaben für die Parameter [kostenpflichtig]:

- customer_addresses_geocoded

- shop_addresses_geocoded

- customer_addresses_all

- shop_addresses_all

Um die ersten 20 Adressen kostenlos zur Überprüfung herunterzuladen, gibt den zusätzliche Parameter:

download_test_datasets=1

Download aller Adressen mit zusätzlichen Informationen:

Da beim Herunterladen alle Adressen mit zusätzlichen Informationen Zusatzkosten entstehen, muss dieser Aufruf mit einem Token bestätigt werden.

Erster HTTP-GET-Aufruf:

https://maps1.locr.com/batch-processing/job_v2.php?action=download&request_id=<RequestId>& download_only=customer_addresses_all&add_lat_long=1

Beispielrückgabe beim Starten einer Kartenproduktion:

<BatchProcessing>

<Response>

<MetaInfo>

<RequestId>4fec2eb23a16880b77000000</RequestId>

<Name>jobname</Name>

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

</MetaInfo>

<TokenRequired>12345678901234567890</TokenRequired>

</Response>

</BatchProcessing>

Rückgabe-Token: 12345678901234567890

HTTP-GET Aufruf mit Bestätigung zur kostenpflichtigen Start des Downloads:

https://maps1.locr.com/batch-processing/job_v2.php?action=download&request_id=<RequestId>& download_only=customer_addresses_all&add_lat_long=1&token=12345678901234567890

Folgende Parameter können zusätzlich optional angegeben werden

    • download_file_start

    • download_file_limit

Mit diesen Parametern kann der Startwert einer Adressdatei, sowie die Anzahl der Daten auf einen Adressraum eingeschränkt werden! Dies ist bei einer großen Anzahl von Adressen sinnvoll, um einen großen Download, auf mehrere kleine Downloads aufzuteilen!

Bsp.:

https://maps1.locr.com/batch-processing/job_v2.php?action=download&request_id=<RequestId>& download_only=maps&download_file_start=1& download_file_limit=10000

Fehlermeldungen:

Beispielrückgabe bei einem Fehler:

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

<Error type="PermissionError" subtype="ContractViolated">

<Details>permanently prohibited</Details>

</Error>