GET/api/pro/export
Die Detektionen in Ihren Zonen, als GeoJSON oder CSV.
Liefert die Satellitendetektionen, die im angeforderten Zeitfenster in Ihre überwachten Zonen fielen. Dieser Export ist auf Ihre Zonen begrenzt: Die weltweiten Daten bleiben Sache der öffentlichen Karte und von NASA FIRMS.
- format
- „geojson“ (Standard) oder „csv“.
- heures
- Zeitfenster in Stunden, 1 bis 168 (7 Tage). Standard 24.
Eine GeoJSON-FeatureCollection aus Punkten (Position, Erfassungszeit, FRP, Satellit, Quelle, Zone), oder eine gleichwertige CSV-Datei. Begrenzt auf 50.000 Zeilen; darüber hinaus das Zeitfenster verkleinern.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/export?format=csv&heures=48"
GET/api/pro/zones
Die Liste Ihrer überwachten Zonen.
Ohne Parameter wird das Zoneninventar zurückgegeben (Name, Fläche, Alarmeinstellungen). Mit `format=geojson` die vollständige FeatureCollection der Flächen, dieselbe, die der Abonnentenbereich und ein GIS laden.
- format
- „geojson“ für die vollständige FeatureCollection der Flächen.
Ein Array von Zonen ({ id, name, surfaceKm2, Alarmeinstellungen, letzter Alarm }), oder eine GeoJSON-FeatureCollection bei `format=geojson`.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/zones"
POST/api/pro/zones
Eine Zone erstellen.
Erstellt eine Zone aus einem GeoJSON-Polygon oder -MultiPolygon in geografischen Koordinaten (EPSG:4326). Die Fläche ist auf 25.000 km² begrenzt, die Größenordnung eines großen französischen Départements: darüber hinaus ist es kein zu überwachender Standort mehr, sondern eine Datenernte, der der Flächenexport besser dient.
- name
- Der Name der Zone (JSON-Body).
- geometry
- Ein GeoJSON-Polygon oder -MultiPolygon, EPSG:4326 (JSON-Body).
Die erstellte Zone mit ihrer ID, als 201 Created.
curl -X POST -H "Authorization: Bearer gfp_..." -H "Content-Type: application/json" \
-d '{"name":"Ostgebiet","geometry":{"type":"Polygon","coordinates":[[...]]}}' \
"https://gisfire.saro.app/api/pro/zones"GET/api/pro/alertes
Das Protokoll versendeter Alarme und Hinweise.
Liefert das Kontoprotokoll: Zonen-Detektionsalarme und persönliche Rauch- oder Blitzhinweise, zusammen, nach Datum sortiert. Nützlich, um sich nach einem verpassten Webhook zu resynchronisieren.
- limite
- Maximale Anzahl an Einträgen, 1 bis 500. Standard 100.
Ein Array von Einträgen ({ type: feu | fumee | foudre, Zone, Zeitraum, Detektionen, maximaler FRP, Versand per E-Mail/Webhook/SMS, Datum }).
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/alertes?limite=50"
GET/api/pro/bilan
Die Kontobilanz über einen Zeitraum.
Die vollständige Bilanz über ein Zeitfenster: erhaltene Alarme, um Ihre Zonen archivierte Brände, Monatsreihe, Exposition je Zone, eingesetzte Luftmittel. Das ist die Grundlage der monatlichen E-Mail-Zusammenfassung.
- periode
- „30j“, „saison“, „12m“ oder „tout“.
- debut
- Startdatum JJJJ-MM-TT, für ein freies Zeitfenster (hat Vorrang vor periode).
- fin
- Enddatum JJJJ-MM-TT, eingeschlossen.
- zones
- Kommagetrennte Zonen-IDs; ohne Angabe alle Zonen.
- detail
- „0“, um das ausführliche Protokoll und die Zeitleiste wegzulassen.
Ein Objekt mit der Bilanz des Zeitraums, plus dem Ausbruchsprotokoll, der Zeitleiste, den Alarmzeiten und der Zusammenfassung der Luftmittel, wenn `detail` nicht 0 ist.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/bilan?periode=saison"
GET/api/pro/historique
Wo es über die Zeit am meisten brennt.
Ranglisten nach französischem Département und Gemeinde über einen Zeitraum, sowie archivierte Brände als Punkte für eine Karte. Dient dazu, die Wiederkehrhäufigkeit von Feuer rund um einen Standort zu messen.
- periode
- „30j“, „saison“, „12m“ oder „tout“.
- debut
- Startdatum JJJJ-MM-TT, für ein freies Zeitfenster.
- fin
- Enddatum JJJJ-MM-TT, eingeschlossen.
Ein Objekt { periode, classements, foyers }.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/historique?periode=12m"
GET/api/pro/alertes/cap
Ihr Alarmprotokoll im Format CAP 1.2.
Dasselbe Protokoll wie /api/pro/alertes, im Format OASIS CAP 1.2 (XML), das Lagewerkzeuge und Bereitschaftsautomaten lesen. Der Umschlag ist ein schlichtes Element <alertes>: jedes darin enthaltene <alert> ist ein vollständiges, abtrennbares CAP-Dokument. Der Schweregrad wird stets als Unknown ausgewiesen, und zwar bewusst: GISFire misst eine Strahlungsleistung und eine Pixelzahl, die nichts darüber aussagen, was am Boden bedroht ist. Der Messwert steht in den <parameter>.
- limite
- Höchstzahl der Alarme, von 1 bis 500. Standard 50.
Ein XML-Dokument (application/xml) in UTF-8. Jeder Alarm trägt sein Gebiet: das Polygon des Gebiets, das Polygon Ihres Alarmrands und einen Kreis für die Beobachtungsdistanz. Die Texte folgen der Sprache Ihrer Benachrichtigungen.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/alertes/cap?limite=20"
GET/api/pro/alertes/{id}/cap
Ein einzelner Alarm im Format CAP 1.2.
Das CAP-Dokument eines einzelnen Eintrags. Die blosse Kennung (12) bezeichnet eine Feuerdetektion; ein Hinweis wird mit seinem Typ geschrieben (fumee-3, foudre-7), da beide Protokolle eigene Zähler haben. Antwortet mit 404, wenn der Alarm nicht existiert oder zu einem anderen Konto gehört.
Ein XML-Dokument (application/xml) mit einem einzigen Element <alert>.
curl -H "Authorization: Bearer gfp_..." \
"https://gisfire.saro.app/api/pro/alertes/feu-21/cap"