Cellsignal

Mobiloperatörers signalstyrka har mätts på flera platser i Sverige med småflyg, cirka 165 meter över marken.
Inom kort tillförs även mätdata från drönarflygningar mellan 60-120 meter.

API Endpoints

Kom igång snabbt med Postman

Här kan du hämta en komplett Postman collection med alla API endpoints förberedda och redo att testa. Collectionen innehåller 16 olika testfall som demonstrerar alla funktioner i API:et.

Ladda ner Postman Collection

Importera filen i Postman och börja testa API:et direkt. Alla exempel är konfigurerade för Göteborgsområdet.

Filtreringsmöjligheter

Både cirkel- och polygon-sökning stöder samma filtreringsalternativ:

Datumfiltrering

Använd from_date för att hämta mätningar från ett specifikt datum och framåt
Använd to_date för att hämta mätningar upp till ett specifikt datum
Använd båda för att begränsa till ett specifikt datumintervall

Operatörsfiltrering

Ange mncs som array med MNC-koder för specifika operatörer
Utelämna mncs eller sätt till null för alla operatörer

Teknologifiltrering

Ange technologies som array med teknologier
Utelämna technologies eller sätt till null för alla teknologier

Signalstyrkefiltrering

Ange include_only_rsrp_rssi_below för dålig signalstyrka
Typiska värden: -100 (mycket dålig), -90 (dålig), -80 (acceptabel)

Följande endpoints är tillgängliga för att konsumera signalstyrkedata:

1. Cirkel-sökning

Endpoint: POST /api/circle.php

Sök efter mätvärden inom en cirkel baserat på en centralpunkt och radie.

Request Body (JSON):

{
  "center": {
    "lat": 57.7089,
    "lon": 11.9746
  },
  "radius_meters": 1000,
  "from_date": "2024-01-15",
  "to_date": "2024-01-20",
  "mncs": [240, 242],
  "technologies": ["LTE", "5G"],
  "limit": 1000,
  "offset": 0
}

Parametrar:

center (obligatorisk): Objekt med lat/lon för centralpunkt
radius_meters (obligatorisk): Radie i meter
from_date (valfri): Startdatum för mätningar (YYYY-MM-DD format)
to_date (valfri): Slutdatum för mätningar (YYYY-MM-DD format)
dates (valfri): Array med specifika mätningsdatum (bakåtkompatibilitet)
mncs (valfri): Array med MNC-koder för operatörer. Om utelämnad eller null returneras alla operatörer
technologies (valfri): Array med teknologier (LTE, 5G, etc.). Om utelämnad eller null returneras alla teknologier
include_only_rsrp_rssi_below (valfri): Filtrera endast mätningar med RSRP/RSSI under detta värde (t.ex. -100 för dålig signalstyrka)
limit (valfri): Max antal resultat (standard: 1000, max: 10000)
offset (valfri): För paginering (standard: 0)

Response Exempel:

{
  "success": true,
  "data": [
    {
      "lat": 57.7089,
      "lon": 11.9746,
      "rsrp_rscp_rssi": -85.5,
      "technology": "LTE",
      "mnc": 240,
      "operator_name": "Telia",
      "measurement_date": "2024-01-15",
      "time": "14:30:25",
      "distance": 0.0
    },
    {
      "lat": 57.7091,
      "lon": 11.9748,
      "rsrp_rscp_rssi": -92.3,
      "technology": "5G",
      "mnc": 242,
      "operator_name": "Telenor",
      "measurement_date": "2024-01-15",
      "time": "14:31:10",
      "distance": 25.4
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 1000,
    "offset": 0,
    "has_more": false
  },
  "query": {
    "center": {
      "lat": 57.7089,
      "lon": 11.9746
    },
    "radius_meters": 1000,
    "filters": {
      "from_date": "2024-01-15",
      "to_date": "2024-01-20",
      "mncs": [240, 242],
      "technologies": ["LTE", "5G"],
      "include_only_rsrp_rssi_below": null
    }
  },
  "area_info": {
    "has_measurements": true,
    "warning": null
  }
}

2. Polygon-sökning

Endpoint: POST /api/polygon.php

Sök efter mätvärden inom en polygon definierad av en serie punkter.

Request Body (JSON):

{
  "polygon": [
    {"lat": 57.7089, "lon": 11.9746},
    {"lat": 57.7189, "lon": 11.9746},
    {"lat": 57.7189, "lon": 11.9846},
    {"lat": 57.7089, "lon": 11.9846}
  ],
  "from_date": "2024-01-15",
  "to_date": "2024-01-20",
  "mncs": [240],
  "technologies": ["LTE"],
  "limit": 1000,
  "offset": 0
}

Parametrar:

polygon (obligatorisk): Array med minst 3 punkter som definierar polygonen
from_date (valfri): Startdatum för mätningar (YYYY-MM-DD format)
to_date (valfri): Slutdatum för mätningar (YYYY-MM-DD format)
dates (valfri): Array med specifika mätningsdatum (bakåtkompatibilitet)
mncs (valfri): Array med MNC-koder för operatörer. Om utelämnad eller null returneras alla operatörer
technologies (valfri): Array med teknologier. Om utelämnad eller null returneras alla teknologier
include_only_rsrp_rssi_below (valfri): Filtrera endast mätningar med RSRP/RSSI under detta värde (t.ex. -100 för dålig signalstyrka)
limit (valfri): Max antal resultat (standard: 1000, max: 10000)
offset (valfri): För paginering (standard: 0)

Response Exempel:

{
  "success": true,
  "data": [
    {
      "lat": 57.7089,
      "lon": 11.9746,
      "rsrp_rscp_rssi": -78.2,
      "technology": "LTE",
      "mnc": 240,
      "operator_name": "Telia",
      "measurement_date": "2024-01-15",
      "time": "14:30:25"
    },
    {
      "lat": 57.7091,
      "lon": 11.9748,
      "rsrp_rscp_rssi": -88.7,
      "technology": "5G",
      "mnc": 242,
      "operator_name": "Telenor",
      "measurement_date": "2024-01-15",
      "time": "14:31:10"
    }
  ],
  "pagination": {
    "total": 75,
    "limit": 1000,
    "offset": 0,
    "has_more": false
  },
  "query": {
    "polygon": [
      {"lat": 57.7089, "lon": 11.9746},
      {"lat": 57.7189, "lon": 11.9746},
      {"lat": 57.7189, "lon": 11.9846},
      {"lat": 57.7089, "lon": 11.9846}
    ],
    "filters": {
      "from_date": "2024-01-15",
      "to_date": "2024-01-20",
      "mncs": [240, 242],
      "technologies": ["LTE", "5G"],
      "include_only_rsrp_rssi_below": null
    }
  },
  "area_info": {
    "has_measurements": true,
    "warning": null
  }
}

3. Lista operatörer och teknologier

Endpoint: GET /api/operators.php

Hämta lista över tillgängliga operatörer, teknologier och mätningsdatum.

Response:

{
  "success": true,
  "data": {
    "operators": [
      {"mnc": 240, "operator_name": "Telia"},
      {"mnc": 242, "operator_name": "Telenor"}
    ],
    "technologies": ["LTE", "5G", "3G"],
    "measurement_dates": ["2024-01-16", "2024-01-15"],
    "total_measurements": 150000
  }
}

Response Format

Alla endpoints returnerar JSON med följande struktur:

{
  "success": true,
  "data": [...],
  "pagination": {
    "total": 1500,
    "limit": 1000,
    "offset": 0,
    "has_more": true
  },
  "query": {
    // Upprepar sökparametrarna
  }
}

Data Format

Varje mätvärde innehåller:

lat: Breddgrad
lon: Längdgrad
rsrp_rscp_rssi: Signalstyrka
technology: Teknologi (LTE, 5G, etc.)
mnc: MNC-kod för operatör
operator_name: Operatörsnamn
measurement_date: Mätningsdatum
time: Tidpunkt för mätning
distance: Avstånd från centralpunkt (endast cirkel-sökning)

Response Metadata:

area_info.has_measurements: Boolean som indikerar om det finns mätningar i området
area_info.warning: Varningstext om inga mätningar finns i området

Exempel på användning

Här är exempel på hur du kan använda API:et med JavaScript:

Cirkel-sökning med datumintervall:

// Sök inom 500m från västra Göteborg mellan 15-20 januari 2024
const response = await fetch('/api/circle.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    center: { lat: 57.7089, lon: 11.9746 },
    radius_meters: 500,
    from_date: '2024-01-15',
    to_date: '2024-01-20',
    technologies: ['LTE', '5G'],
    limit: 100
  })
});

const data = await response.json();
console.log(data.data); // Array med mätvärden

Polygon-sökning med endast från-datum:

// Sök inom polygon från 1 januari 2024 och framåt
const response = await fetch('/api/polygon.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    polygon: [
      {lat: 57.7089, lon: 11.9746},
      {lat: 57.7189, lon: 11.9746},
      {lat: 57.7189, lon: 11.9846},
      {lat: 57.7089, lon: 11.9846}
    ],
    from_date: '2024-01-01',
    mncs: [240, 242]
  })
});

const data = await response.json();
console.log(data.data); // Array med mätvärden

Minimal sökning (alla operatörer och teknologier):

// Sök inom 1km från västra Göteborg - alla operatörer och teknologier inkluderade
const response = await fetch('/api/circle.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    center: { lat: 57.7089, lon: 11.9746 },
    radius_meters: 1000
    // Ingen mncs eller technologies = alla inkluderade
  })
});

const data = await response.json();
console.log(data.data); // Array med mätvärden från alla operatörer och teknologier

Sökning efter dålig signalstyrka:

// Hitta områden med dålig signalstyrka (under -100 dBm)
const response = await fetch('/api/circle.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    center: { lat: 57.7089, lon: 11.9746 },
    radius_meters: 2000,
    include_only_rsrp_rssi_below: -100,
    technologies: ['LTE', '5G']
  })
});

const data = await response.json();
console.log(data.data); // Endast mätningar med dålig signalstyrka
console.log(data.area_info.has_measurements); // true/false om det finns mätningar i området
if (data.area_info.warning) {
  console.warn(data.area_info.warning); // Varning om inga mätningar finns
}

Signalstyrka mobildatanät - API

API Endpoints

Kom igång snabbt med Postman

Filtreringsmöjligheter

Datumfiltrering

Operatörsfiltrering

Teknologifiltrering

Signalstyrkefiltrering

1. Cirkel-sökning

Request Body (JSON):

Parametrar:

Response Exempel:

2. Polygon-sökning

Request Body (JSON):

Parametrar:

Response Exempel:

3. Lista operatörer och teknologier

Response:

Response Format

Data Format

Response Metadata:

Exempel på användning

Cirkel-sökning med datumintervall:

Polygon-sökning med endast från-datum:

Minimal sökning (alla operatörer och teknologier):

Sökning efter dålig signalstyrka: