
import requests
import json

# Vorbereitung für REST-Requests

# Session
hostname = "https://tour.multiroute.de/" # für SaaS; für InHouse entsprechend anpassen "https://tour.multiroute.de/"
session = requests.Session()

# Authentifizierung
session.auth = ("USERNAME", "PASSWORD") # Credentials
auth = session.post(hostname)

# Header
headers_mrt = {'Content-type': 'application/json'}


# Bsp. data mit Koordinaten

data = {
"update": True,
"insert": True, 
"adresse": [{
    "oi": "GBC93385",
    "plz": "10119",
    "ort": "Berlin",
    "ort_zusatz": None,
    "strasse": "Schwedter Straße",
    "hausnummer": "22",
    "hausnummer_zusatz": "",
    "is_active": True,
    "notice": None,
    "privathaushalte": 0,
    "gewerbebetriebe": 0,
    "werbeverweigerer": 0,
    "longitude": 52.5347133208835,
    "latitude": 13.4075689315796
}, {
    "oi": "GBC360693",
    "plz": "84030",
    "ort": "Ergolding",
    "ort_zusatz": None,
    "strasse": "Schinderstraßl",
    "hausnummer": "5",
    "hausnummer_zusatz": "D",
    "is_active": True,
    "notice": None,
    "privathaushalte": 0,
    "gewerbebetriebe": 0,
    "werbeverweigerer": None,
    "longitude": 12.1660333871841,
    "latitude": 48.5649005287186
}]
 }


# Bsp. data ohne Koordinaten

data = {
"update": True,
"insert": True, 
"adresse": [{
    "oi": None,
    "plz": "10119",
    "ort": "Berlin",
    "ort_zusatz": None,
    "strasse": "Schwedter Straße",
    "hausnummer": "22",
    "hausnummer_zusatz": "",
    "is_active": True,
    "notice": None,
    "privathaushalte": 0,
    "gewerbebetriebe": 0,
    "werbeverweigerer": 0
    # entweder lat long ganz weglassen ...
}, {
    "oi": None,
    "plz": "84030",
    "ort": "Ergolding",
    "ort_zusatz": None,
    "strasse": "Schinderstraßl",
    "hausnummer": "5",
    "hausnummer_zusatz": "D",
    "is_active": True,
    "notice": None,
    "privathaushalte": 0,
    "gewerbebetriebe": 0,
    "werbeverweigerer": None,
    # ... oder None angeben - beides funktioniert.
    "longitude": None,
    "latitude": None
}]
 }


res = session.post(hostname + 'fernsteuerung/add_and_update_adresse/', headers=headers_mrt, data=json.dumps(data))
obj = json.loads(res.text)
upload_id = obj["upload_id"]
obj

{'upload_id': 587699,
 'text': '2 Adressen hinzugefügt, 0 Adressen geupdated ',
 'added': 2,
 'updated': 0}


res = session.get('{}fernsteuerung/check_geocode?upload_id={}'.format(hostname, upload_id))
obj = json.loads(res.text)
obj

{'upload_id': 587699, 'status': None, 'geocoded': 2, 'not_geocoded': 0}


# Es können auch mehrere Planungen auf einmal angelegt werden. Hier für zwei Werktage.

data = {"update": True,
"insert": True, 
"planung": [{
    "nr": "Montag, 04.10.2021",
    "name": "",
    "depot": None 
}, {
    "nr": "Dienstag, 05.10.2021",
    "name": "",
    "depot": None}] }

res = session.post(hostname + 'fernsteuerung/planung/add_and_update/', headers=headers_mrt, data=json.dumps(data))
obj = json.loads(res.text)
obj

{'text': '2 Planungen hinzugefügt, 0 Planungen geupdated ',
 'added': 2,
 'updated': 0}


data = {
  "auftraege": [{
    "adresse_oid": "GBC360693",
    "planung_nr": "Montag, 04.10.2021",
    "name": "Musterauftrag, Kunde XYZ",
    "timewindows": "[08:00,12:00];[14:00,18:00]",
    "capacity": "2000" 
  }]
}

# mehr Aufträge hinzufügen!

res = session.post(hostname + 'fernsteuerung/auftrag/', headers=headers_mrt, data=json.dumps(data))
obj = json.loads(res.text)
obj

{'status': 200,
 'text': 'Aufträge erfolgreich angelegt.',
 'auftraege': [{'ext_id': None, 'id': 1391922011}]}


# Flotte mit 4 Fahrzeugen: 2 Sprinter, 1 PKW, 1 Kühlfahrzeug mit entsprechendem Skill

data = {
  "fleet": {
    "name": "Standardflotte",
    "vehicles": [
      {
        "name": "Sprinter",
        "number": 2,
        "amount": 2,
        "start": {
          "type": "start",
          "oid": "GBC31894593"
        },
        "end": {
          "type": "end",
          "oid": "GBC31894593"
        },
        "capacity": 1800000,
        "driving": "[08:00,12:00]",
        "break": {
          "timewindows": "[]",
          "duration": 0
        },
        "skills": [""]
      },
      {
        "name": "PKW",
        "number": 3,
        "amount": 2,
        "start": {
          "type": "start",
          "oid": "GBC31894593"
        },
        "end": {
          "type": "end",
          "oid": "GBC31894593"
        },
        "capacity": 800000,
        "driving": "[08:00,12:00]",
        "break": {
          "timewindows": "[]",
          "duration": 0
        },
        "skills": [""]
      },
      {
        "name": "Kühlfahrzeug",
        "number": 1,
        "amount": 1,
        "start": {
          "type": "start",
          "oid": "GBC31894593"
        },
        "end": {
          "type": "end",
          "oid": "GBC31894593"
        },
        "capacity": 1200000,
        "driving": "[08:00,12:00]",
        "break": {
          "timewindows": "[]",
          "duration": 0
        },
        "skills": [
          "Kühlfahrzeug"
        ]
      }
    ]
  }
}

res = session.post(hostname + 'fernsteuerung/flotte/', headers=headers_mrt, data=json.dumps(data))
obj = json.loads(res.text)
obj

{'status': 200, 'fleet_id': 3525}


data = {
  "planung": "Montag, 04.10.2021",
  "fleet_name": "Standardflotte", # oder fleet_id, hier: 2913
  "tour": {
    "zeit_distanz": "zeit",
    "flat_deploy_time": 5.0,
    "deploy_time": 0.1,
    "maximum_jobs_per_vehicle": 100,
    "ignore_capacity_constraints": False,
    "zeit_distanz": "zeit"
  }
}

res = session.post(hostname + 'fernsteuerung/tour/berechnen', headers=headers_mrt, data=json.dumps(data))
obj = json.loads(res.text)
obj

{'status': 200, 'tour_id': 11735}


# Key "success" prüfen ob bereits fertig berechnet. Falls nein, folgt der Output diesem Schema.

res = session.get(hostname + 'fernsteuerung/tour/' + "11735", headers=headers_mrt)
obj = json.loads(res.text)
obj

{'touren': [],
 'meta': {'id': 11735,
  'datenstand_osm': None,
  'success': None,
  'anz_fahrzeuge': None,
  'abladestellen': None,
  'error_message': '<p>Tour 11735 wird gerade berechnet.</p><p>Bitte haben Sie noch etwas Geduld.</p>',
  'horizont': None,
  'deploy_time': 0.1,
  'flat_deploy_time': '5.0',
  'max_deliver_time': None,
  'unassigned_jobs': None,
  'planung': 'Montag, 04.10.2021',
  'fleet': 'Standardflotte',
  'fleet_id': 3525,
  'zeit_distanz': 'Zeit',
  'gewicht': 0.0,
  'gewicht_text': 'kg',
  'strecke': 0.0,
  'dauer': 0.0,
  'wartezeit': 0.0,
  'entladedauer': 0.0,
  'gesamtdauer': 0.0,
  'berechnet_am': '08.07.2021 09:15',
  'depot_departure_time': None}}


# Wenn fertig, ganzes Tourenobjekt genauso abfragen.
res = session.get(hostname + 'fernsteuerung/tour/' + "11735", headers=headers_mrt)
obj = json.loads(res.text)
obj


# Bessere JSON Visualisierung in Jupyter Notebooks.
from IPython.display import JSON
JSON(obj)

API-Ablauf Python Beispiel¶

Vorbereitung¶

1. Adressen hochladen¶

2. Geokodierung der Adressen prüfen¶

3. Planung anlegen¶

4. Aufträge an Adresse spielen und Planung zuweisen¶

5. Flotte anlegen¶

6. Tourberechnung starten¶

7. Prüfen ob Tourberechnung fertig & abfragen¶