Données de capteur LoRa

Description à venir.

Liste des capteurs

Emplacement des capteurs

Modèle de données

{
  "id": "LoRaDataFrame:LORA-FRAME-Aura-0141-001A",
  "type": "LoRaDataFrame",
  "adr": {
    "type": "Boolean",
    "value": true
  },
  "applicationID": {
    "type": "Text",
    "value": "8"
  },
  "applicationName": {
    "type": "Text",
    "value": "eLichens-Aura"
  },
  "confirmedUplink": {
    "type": "Boolean",
    "value": false
  },
  "data": {
    "type": "Text",
    "value": "200f4390e43a7e3a03e1d2"
  },
  "dataProvider": {
    "type": "Text",
    "value": "Métropole Nice Côte d%27Azur"
  },
  "dateModified": {
    "type": "DateTime",
    "value": "2024-07-04T11:05:59.112Z"
  },
  "dateObserved": {
    "type": "DateTime",
    "value": "2024-07-04T11:05:59.112Z"
  },
  "devAddr": {
    "type": "Text",
    "value": "1373e09d"
  },
  "devEUI": {
    "type": "Text",
    "value": "e11cd4710141001a"
  },
  "deviceName": {
    "type": "Text",
    "value": "Aura-0141-001A"
  },
  "dr": {
    "type": "Number",
    "value": 0
  },
  "fCnt": {
    "type": "Number",
    "value": 1908
  },
  "fPort": {
    "type": "Number",
    "value": 1
  },
  "rxInfo": {
    "type": "StructuredValue",
    "value": [
      {
        "antenna": 0,
        "rssi": -117,
        "fineTimestampType": "NONE",
        "channel": 1,
        "timeSinceGPSEpoch": "1404126376.698s",
        "rfChain": 0,
        "context": "13e4205c",
        "location": {
          "altitude": 45,
          "latitude": 43.68062,
          "accuracy": 0,
          "source": "UNKNOWN",
          "longitude": 7.20347
        },
        "uplinkID": "407160af28c7470688e537a5a4a99115",
        "time": "2024-07-04T11:05:58.698061Z",
        "gatewayID": "00800000a0003634",
        "loRaSNR": -2.5,
        "board": 0,
        "crcStatus": "CRC_OK"
      }
    ]
  },
  "source": {
    "type": "Text",
    "value": "LoRa Server"
  },
  "tags": {
    "type": "Number",
    "value": {}
  },
  "txInfo": {
    "type": "StructuredValue",
    "value": {
      "modulation": "LORA",
      "loRaModulationInfo": {
        "spreadingFactor": 12,
        "bandwidth": 125,
        "polarizationInversion": false,
        "codeRate": "4/5"
      },
      "frequency": 868300000
    }
  }
}

Documentation relative à l'API

La documentation est utile aux développeurs désirant utiliser l'API fournie par la Métropole Nice Côte d'Azur.

Exemple de code

• Temps réel – Dernière valeur reçue au moment de la requête
  • Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"
  • Cas d'usage 2 : Renvoie les données d'un ID donné
  • Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné
• Historique
  • Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

Curl

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"

curl -X GET "https://api.nicecotedazur.org/nca/lora/dataframe?idPattern=^LoRaDataFrame:LORA-FRAME&api_key=API_KEY"

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005?api_key=API_KEY"

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005?attrs=fcnt&api_key=API_KEY"

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/lora/dataframe/histo/LoRaDataFrame:LORA-FRAME-Aura-141-0005?attrs=fcnt&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"

Java

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case1 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/lora/dataframe?idPattern=^LoRaDataFrame:LORA-FRAME&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case2 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005?api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case3 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005?attrs=fcnt&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case4 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/lora/dataframe/histo/LoRaDataFrame:LORA-FRAME-Aura-141-0005?attrs=fcnt&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

Javascript

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"

const url = "https://api.nicecotedazur.org/nca/lora/dataframe"
 
const params = {
    idPattern: '^LoRaDataFrame:LORA-FRAME',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

const url = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005"
 
const params = {
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005"
 
const params = {
    attrs: 'fcnt',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/lora/dataframe/histo/LoRaDataFrame:LORA-FRAME-Aura-141-0005"
 
const params = {
    attrs: 'fcnt',
    fromDate: '2023-07-01T09:00:00',
    toDate: '2023-07-31T09:00:00',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

Python

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/lora/dataframe"
searchParams = {
  'idPattern': "^LoRaDataFrame:LORA-FRAME",
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005"
searchParams = {
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005"
searchParams = {
  'attrs': 'fcnt',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/lora/dataframe/histo/LoRaDataFrame:LORA-FRAME-Aura-141-0005"
searchParams = {
  'attrs': 'fcnt',
  'fromDate': '2023-07-01T09:00:00',
  'toDate': '2023-07-31T09:00:00',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

C#

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "LoRaDataFrame"

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case1
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/lora/dataframe";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "idPattern=^LoRaDataFrame:LORA-FRAME&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case2
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case3
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/lora/dataframeLoRaDataFrame:LORA-FRAME-Aura-141-0005";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=fcnt&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case4
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/lora/dataframe/histo/LoRaDataFrame:LORA-FRAME-Aura-141-0005";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=fcnt&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}