Eksport JSON, CSV i CHIRP

api Endpointy HTTP

GET /api/export/json

GET /api/export/csv

GET /api/export/chirp

GET /api/export/json?band=2m&mode=fm
GET /api/export/csv?prefix=SR5&status=working
GET /api/export/chirp?latitude=52.23&longitude=21.01&range=50&band=2m

curl -o przemienniki.csv "https://przemienniki.eu/api/export/csv?prefix=SR9&band=70cm&mode=fm&status=working"
curl -o id51.csv "https://przemienniki.eu/api/export/radio/icom_id_51?mode=fmpoland,fmlink"

data_object Format JSON

Plik JSON to tablica obiektów. Każdy obiekt opisuje jeden przemiennik z współrzędnymi. Rekordy bez poprawnej lokalizacji nie trafiają do eksportu.

• callsign — znak przemiennika.
• modes — tablica trybów emisji (tylko tryby: fm, dmr, c4fm, dstar, tetra, apco25, nxdn, m17, atv), np. ["fm", "dmr"].
• networks — tablica sieci / systemów łączenia: echolink, fmpoland, fmlink, minilink, extremelink; pusta tablica, gdy przemiennik nie należy do żadnej sieci.
• tx_frequency, rx_frequency — częstotliwości w MHz albo false.
• tx_ctcss, rx_ctcss — ton CTCSS albo false.
• rx_1750 — czy stacja obsługuje ton 1750 Hz.
• duplex — "+", "-" albo false.
• offset — przesunięcie częstotliwości w MHz.
• status — status operacyjny, np. working.
• coordinates — para [latitude, longitude].
• qth, locator — lokalizacja tekstowa i lokator w ASCII.

[
  {
    "callsign": "SR8XYZ",
    "modes": ["fm"],
    "networks": ["fmpoland"],
    "tx_frequency": 438.7,
    "tx_ctcss": 88.5,
    "rx_frequency": 431.1,
    "rx_ctcss": 88.5,
    "rx_1750": false,
    "duplex": "-",
    "offset": 7.6,
    "status": "working",
    "coordinates": [50.0375, 22.0047],
    "qth": "Rzeszow",
    "locator": "KO00aa"
  }
]

table Format CSV

Plik CSV ma nagłówek w pierwszym wierszu. Kolumny odpowiadają polom z eksportu JSON, z osobnymi kolumnami Latitude i Longitude zamiast tablicy coordinates. Wartości tekstowe z przecinkami są cytowane zgodnie ze standardem CSV.

Kolumna Modes zawiera tylko tryby emisji, a Networks — sieci (np. echolink, fmpoland). Wiele wartości w jednej komórce oddziela przecinek ze spacją; komórka jest wtedy ujęta w cudzysłów, np. "fm, dmr".

Kolejność kolumn:

Callsign, Modes, Networks, TX Frequency, TX CTCSS, RX Frequency, RX CTCSS, RX 1750, Duplex, Offset, Status, Latitude, Longitude, QTH, Locator

Callsign,Modes,Networks,TX Frequency,TX CTCSS,RX Frequency,RX CTCSS,RX 1750,Duplex,Offset,Status,Latitude,Longitude,QTH,Locator
SR8XYZ,fm,fmpoland,438.7,88.5,431.1,88.5,false,-,7.6,working,50.0375,22.0047,Rzeszow,KO00aa

radio Format CHIRP (CSV)

Plik CHIRP ma kolumny zgodne z importem w programie CHIRP, m.in. Location, Name, Frequency, Duplex, Offset, Tone, rToneFreq, Mode i Comment.

Pełna kolejność kolumn (format generic CSV programu CHIRP):

Location,Name,Frequency,Duplex,Offset,Tone,rToneFreq,cToneFreq,DtcsCode,DtcsPolarity,RxDtcsCode,CrossMode,Mode,TStep,Skip,Power,Comment,URCALL,RPT1CALL,RPT2CALL,DVCODE
0,SR9FMJ,438.400000,-,7.600000,Tone,67.0,67.0,023,NN,023,Tone->Tone,FM,5.00,,50W,Jaworzyna krynicka,,,,
9,SR5UZQ,438.862500,-,7.636000,,88.5,88.5,023,NN,023,Tone->Tone,DV,6.25,,50W,Krze Duze,CQCQCQ,SR5UZQ B,SR5UZQ G,

• Eksport zawiera tylko przemienniki FM (także z sieciami FM Polska, FM-Link, EchoLink, MiniLink, Extreme-Link) i D-STAR. Przemienniki wyłącznie DMR, C4FM, TETRA, APCO-25, NXDN, M17 czy ATV są pomijane — CHIRP nie obsługuje tych trybów.
• Mode: FM dla FM i sieci analogowych, DV tylko dla D-STAR bez FM. Dla DV wypełniane są URCALL (CQCQCQ), RPT1CALL (znak + moduł, 8 znaków) i RPT2CALL (znak + G).
• Duplex: puste (simpleks), -, + albo split dla przemienników crossband — wtedy Offset to częstotliwość nadawania radia.
• TStep dobierany do częstotliwości (5.00 albo 6.25 kHz, np. dla 438.8625 MHz), Tone tylko dla standardowych tonów CTCSS, Power = 50W (CHIRP wymaga tej kolumny; radia bez wyboru mocy, np. ID-51, ją ignorują).
• Name i Comment tylko w ASCII (bez polskich znaków), nazwa do 16 znaków.

Eksport pod konkretne radio (/api/export/radio/<id-modelu>) używa tego samego formatu i dodatkowo ogranicza pasma, długość nazwy i liczbę pamięci. Dla Icom ID-51 wybierz model icom_id_51 (pasma 144–146 i 430–440 MHz, bez przemienników crossband), wczytaj plik w CHIRP (File → Import) i wyślij do radia.

tips_and_updates Uwagi praktyczne

• Eksport JSON używa kodowania UTF-8 i wcięć dla czytelności.
• Eksport CSV używa kodowania UTF-8 i przecinka jako separatora.
• Pola częstotliwości i CTCSS mogą być puste lub oznaczone jako false, gdy dane nie są dostępne.
• Rekordy bez poprawnej lokalizacji nie trafiają do eksportu.