BATCH-Jobs‎ > ‎

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>

Parameter

Beschreibung

maps    

Karten als komprimierte ZIP-Datei herunterladen.

customer_addresses_not_geocoded

Kunden-Adressen herunterladen die NICHT Geocodiert werden konnten.

shop_addresses_not_geocoded

Ziel-Adressen herunterladen die NICHT Geocodiert werden konnten.

customer_addresses_geocoded

Kunden-Adressen herunterladen die Geocodiert werden konnten.

shop_addresses_geocoded

Ziel-Adressen herunterladen die Geocodiert werden konnten.

customer_addresses_all

Alle Kunden-Adressen herunterladen.

Zusätzliche Daten wie Geocodes (Latitude/Longitude) /Entfernung/ Fahrzeit herunterladen  [kostenpflichtig] *

shop_addresses_all                

Alle Ziel-Adressen herunterladen.

Zusätzliche Daten wie Geocodes (Latitude/Longitude) /Entfernung/ Fahrzeit herunterladen  [kostenpflichtig] *

configuration

Herunterladen der Konfiguration.

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

Parameter

Beschreibung

add_lat_long=1

Fügt dem Adress-Export, die Geocodes (Latitude/Longitude) zu.

add_driving_time=1

Fügt dem Adress-Export, die Fahrzeit zu.

add_distance=1

Fügt dem Adress-Export, die Entfernung zu.

distance_unit=m|km|ft|mi (default: m)

Gibt an in welcher Einheit die Entfernungsangaben ausgegeben werden sollen.



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