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