Die Adresse wird zur Darstellung des Einsatzortes auf der Karte verwendet, sie kann maximal 200 Zeichen enthalten und steht erst ab der ALARM Version zur Verfügung. Wenn Sie der Schnittstelle nur die Adresse übergeben und die Koordinaten nicht im Aufruf enthalten sind, versucht die Schnittstelle diese mittels Geocoding zu ermitteln

Längen- und Breitengrad (lat, lng)

Float-Wert, z.B. 47.4210651 und 10.9766104 für die Zugspitze. Punkt statt Komma verwenden! 
Wenn Sie der Schnittstelle nur die Koordinaten übergeben und die Adresse nicht im Aufruf enthalten ist, versucht die Schnittstelle mittels Reverse Geocoding die postalische Adresse zu ermitteln.

Koordinaten im Gauß-Krüger-Format

In Süddeutschland wird in Alarmdepeschen häufig das Koordinatensystem Gauß Krüger/Deutsches Hauptdreiecksnetz (DHDN) verwendet. Zur Kompatibilität mit den verwendeten Karten-Tools (Google Maps, Esri Argis) kann die Web-API Rechts- und Hochwert automatisch in Längen- und Breitengrad (WGS84) umrechnen.

Nutzen Sie folgende Parameter:

coordinates = gk
coordinates-x = Rechtswert
coordinates-y = Hochwert

Die Gauß-Krüger-Zone wird automatisch anhand der hinterlegten Adresse der Einheit ermittelt.

In der PRO-Version mit einheitsübergreifender Funktionalität, können über die zentrale Alarm-Schnittstelle mehrere Untereinheiten mit einem einzigen Aufruf der API alarmiert werden. 
Sie können den Parameter ric analog zu Gruppen und Fahrzeugen verwenden. Die Datenpflege der "Alarmierungs-RIC" erfolgt jedoch über den zentralen Administrator in den Vorgaben der Untereinheiten. Der Parameter cluster_ids erwartet ein Array mit den Primärschlüsseln der Einheit(en). Zur schnelleren Verarbeitung wird empfohlen, die IDs der Einheiten als Array zu übergeben.

Die Gruppen, die alarmiert werden sollen. Verwenden Sie die Schreibweise aus dem Feld "Alarmierungs-RIC" oder die IDs der gewünschten Gruppen. Der Parameter ric erwartet einen String mit einer oder mehrerer RICs. Mehrere mit Komma getrennt. Der Parameter group_ids erwartet ein Array mit den Primärschlüsseln der Gruppe(n). In DIVERA 24/7 PRO können über den API-Key der zentralen Schnittstelle auch einheitsübergreifende Gruppen (z.B. alle Führungskräfte im Stadtgebiet) alarmiert werden.

Wenn bei Aufruf der API der Parameter "alarmcode_id" gesetzt ist und einer gültigen Alarmvorlage entspricht, wird diese automatisch angewendet.

Im Regelfall muss jedoch der überlieferte Inhalt auf eine inhaltliche Übereinstimmung untersucht werden. Dafür kann in jeder Alarmvorlage im Reiter "API-Einstellungen" definiert werden, ob und unter welchen Umständen die Vorlage über Texterkennung erkannt wird. Wahlweise gar nicht, nur bei exakter Übereinstimmung mit dem Einsatzstichwort oder wenn bestimmte Suchwörter im überlieferten Einsatzstichwort enthalten sind.

Wenn einzelne Felder, z.B. Text/Meldungen oder die alarmierten Fahrzeuge, explizit im Schnittstellen-Aufruf enthalten sind, werden dies nicht vom Alarmvorschlag überschrieben. Mit der Einstellung "Daten des API-Requests überschreiben" können die Daten aus der Vorlage jedoch auch erzwungen werden.

Die Texterkennung muss zudem in den Einstellungen Verwaltung > Einstellungen > Schnittstellen > Alarmierung > Alarmvorlage anhand des Stichworts erkennen manuell aktiviert werden.

Die API nutzt zur Alarmierung und Benachrichtigung immer die Einstellungen gemäß Verwaltung > Einstellungen > Meldungen > Alarmierungen.

Dort ist einzustellen, über welche Kommunikationswege (App/Push-Nachricht, SMS, Sprachanruf, Pager, E-Mail) der Alarm verschickt wird.

Mittels Filter (aktuelle Fahrzeug-Einteilung und/oder aktueller persönlicher Status) wird eingeschränkt, welche Personen die Alarmierung tatsächlich erhalten.

Weitere Einstellungen sind die Intelligente Alarmierung (SMS/Anruf nur für Personen ohne App-Login) und die Rückfallebene (Überprüfung von Empfangsbestätigung oder Einsatz-Rückmeldung, bei fehlender Bestätigung erfolgt automatisch die Benachrichtigung über einen zweiten Weg, z.B. SMS).

Häufig werden für einen einzigen Einsatz mehrere Requests ausgelöst, die regulär zu neuen Alarmierung führen.

Um das ständige Auslösen der App zu unterbinden, kann die API angewiesen werden, mehrfache Aufrufe zu einem Datensatz zusammen zu führen.

In den Einstellungen der API muss "Einsätze bei mehrfachem Aufruf der API zusammenführen" aktiviert werden. Zudem wird eingestellt, innerhalb welcher Zeit das Zusammenführen stattfindet, wie mit den Informationen aus den weiteren Requests umgangenen wird (ignorieren/überschreiben/ergänzen) und ob beim Zusammenführen die eigene Einsatznummer geprüft wird.

Alternativ ist es auch möglich, über den Parameter "id" als Primärschlüssel von DIVERA 24/7 gezielt einen bestehenden Datensatz anzusprechen und zu überschreiben.

Innerhalb des Zeitraums von fünf Minuten kann über die API nur eine Alarmierung ausgelöst werden. Über den API-Request lässt sich nur das Einsatz-Stichwort mit max. 30 Zeichen übertragen.

Ein Upgrade auf die Version ALARM oder PRO bietet viele Vorteile. Die API unterstützt alle Details und verzichtet auf eine zeitliche Limitierung. Über Zusatzmodule wie E-Mail-Auswertung, SMS- und FAX-Inbound können vorhandene Informationskanäle integriert werden. Zur Abbildung vordefinierter Szenarien oder einer Alarm- und Ausrückeordnung (AAO) kann die Schnittstelle außerdem auf Übereinstimmung mit bekannten Alarmvorlagen prüfen und den Einsatz automatisch mit den vordefinierten Eckdaten auslösen.