# 🛰️ fetchGisStatusStations – Geräte-Statusdaten abrufen

## Zweck

Diese Funktion ruft den aktuellen Status aller Stationen (Geräte) für eine bestimmte Karte ab.  
Sie basiert auf dem Webservice `GisStationsStatusDistrict`.

---

## Webservice-Endpunkt

```
GET /talas5/ClientData/WebServiceMap.asmx/GisStationsStatusDistrict?idMap={idMap}&idUser={idUser}
```

---

## Dynamische URL-Erzeugung

Die Funktion nutzt **keine feste URL** aus `.env.local`, sondern erkennt die Umgebung anhand von:

```env
NEXT_PUBLIC_API_PORT_MODE=dev
```

### Beispiel aus dem Code:

```js
const mode = process.env.NEXT_PUBLIC_API_PORT_MODE;

const SERVER_URL =
  mode === "dev"
    ? \`\${window.location.protocol}//\${window.location.hostname}:80\`
    : \`\${window.location.origin}\`;
```

---

## Parameter

| Name     | Typ   | Beschreibung             |
|----------|--------|--------------------------|
| `idMap`  | string | Karten-ID                |
| `idUser` | string | Benutzer-ID              |

---

## Verwendung

Die Funktion nutzt `fetchWithTimeout` mit einem Timeout von 5000 ms.

```js
fetchWithTimeout(
  \`\${SERVER_URL}/talas5/ClientData/WebServiceMap.asmx/GisStationsStatusDistrict?idMap=\${idMap}&idUser=\${idUser}\`,
  { method: "GET", headers: { Connection: "close" } },
  5000
)
```

---

## Fehlerbehandlung

Bei HTTP-Fehlern oder Zeitüberschreitung wird ein Fehler geloggt und erneut geworfen.

```js
if (!response.ok) throw new Error(...);
.catch((error) => {
  console.error(...);
  throw error;
});
```

---

## Siehe auch

- `.env.local` → `NEXT_PUBLIC_API_PORT_MODE`
- `fetchWithTimeout.js`
- `GisStationsStaticDistrict`, `GisSystemStatic`

---

📄 Pfad: `/docs/frontend/services/api/fetchGisStatusStations.md`