Skip to main content

3. Locations (Standorte)

Grundidee

Locations (Standorte) repräsentieren feste Orte, die in DeDeFleet wiederverwendet werden können, zum Beispiel:

  • Depots

  • Lager

  • Niederlassungen

Locations können anschließend:

  • in Aufträgen referenziert werden (location.type = 0)

  • als Start- oder Endpunkt von Touren verwendet werden

  • zentral gepflegt und mehrfach genutzt werden

👉 Locations sind Stammdaten und dienen der Wiederverwendung konsistenter Ortsinformationen.

3.1 Location/Create – Standort anlegen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Location/Location_Create

Zweck

Legt einen neuen Standort in DeDeFleet an.
Der Standort kann anschließend in Aufträgen oder Touren referenziert werden.

Endpoint

POST /location/create

Request Body (Beispiel)

{
  "location": {
    "locationNumber": "LOC-100",
    "name": "Zentrallager Northeim",
    "location": {
      "type": 2,
      "street": "Industriestraße 1",
      "postal": "37154",
      "city": "Northeim",
      "country": "DE"
    },
    "radius": 50
  }
}

Wichtige Felder & Bedeutung

Feld Beschreibung
locationNumber Eindeutige Standortnummer (führende Referenz)
name Bezeichnung des Standorts
location Adress- oder Koordinatenangaben (Location-Typen wie bei Aufträgen)
radius Wirkungsradius des Standorts (z. B. für Planung / Geofencing)

Wirkung im System

  • ✔ Standort wird als Stammdatensatz angelegt

  • ✔ Standort kann in Aufträgen referenziert werden (location.type = 0)

  • ✔ Standort kann als Tour-Start- oder -Endpunkt verwendet werden

3.2 Location/Delete – Standort löschen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Location/Location_Delete

Zweck

Löscht einen Standort anhand der Standortnummer.

Endpoint

POST /location/delete

Request Body

{
  "locationNumber": "LOC-100"
}

Hinweis

  • Das Löschen kann eingeschränkt sein, wenn der Standort bereits in Aufträgen oder Touren verwendet wird

  • In solchen Fällen sollte der Standort nicht gelöscht, sondern ggf. nicht mehr verwendet werden

3.3 Location/Update – Standort ändern

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Location/Location_Update

Zweck

Aktualisiert einen bestehenden Standort.

👉 Es werden ausschließlich die im Request übergebenen Felder geändert.
Nicht übergebene Felder bleiben unverändert.

Endpoint

POST /location/update

Request Body (Minimalbeispiel)

{
  "location": {
    "locationNumber": "LOC-100",
    "name": "Zentrallager Northeim (neu)",
    "radius": 75
  }
}

Typische Anwendungsfälle

  • Namensänderung eines Standorts

  • Anpassung des Radius

  • Änderung der Adresse oder Koordinaten

Wirkung im System

  • ✔ Standort wird aktualisiert

  • ✔ Bestehende Referenzen bleiben erhalten

  • ⚠️ Änderungen an Adresse/Koordinaten können Auswirkungen auf Planung und Routenberechnung haben

Best Practices

  • locationNumber als stabile, eindeutige Referenz verwenden

  • Locations vor der produktiven Planung anlegen

  • Für häufig genutzte Orte (Depots) Locations bevorzugen statt Ad-hoc-Adressen

  • Nach relevanten Änderungen ggf. Touren neu berechnen

Back to top