Eksport danych

Oczywiście dane z naszej bazy wyciągnąć nie jest ciężko. Ktokolwiek ma odrobinę zacięcia w dłubaniu w JavaScript i posiada chociażby FireBuga spokojnie znajdzie sobie URL z którego można wyciągnąć wszystkie przemienniki z naszej mapy. Pewnym problemem mogą być ciasteczka z ustawieniami i tym podobne rzeczy, ale dla chcącego nie ma nic trudnego. Więc, aby zaoszczędzić power userom pracy, a pozostałym zrobić frajdę, oficjalnie umożliwiamy dostęp do wyników z naszej bazy danych.

Oczywiście są pewne uwarunkowania.

Po pierwsze: co prawda zabraniać sobie możemy, a i tak zrobisz co zechcesz, prosimy, aby bez uzgodnienia z nami, dane te nie były wykorzystywane do tworzenia innych stron WWW bądź aplikacji opartych o HTML. Jesteśmy otwarci na współpracę, ale w takim wypadku wolelibyśmy dowiedzieć się co chcesz zrobić. Może uda Ci się wykorzystać pozostałe rozwiązania z naszej mapy.

Po drugie: liczymy, że umieścisz w swoim produkcie informację o tym skąd pochodzą dane. Miłe by było pełnoekranowe logo ;-) Ale jak się nie da to wystarczy kilka słów w "about" :-)

Po trzecie: będziemy wdzięczni mimo wszystko jak napiszesz do nas i powiesz co zrobisz z tymi danymi i co-nieco opowiesz o swoim pomyśle. Może i my dorzucimy trzy grosze?

Na chwilę obecną udostępniamy następujące formaty eksportu:

Parametry w URL

Niektóre z powyższych formatów obsługują parametry w URL:

Dla większości z powyższych parametrów można podać więcej niż jedną wartość, oddzielając je przecinkami. Dla przykładu:

http://przemienniki.net/export/przemienniki.xls?country=pl - wygeneruje nam plik XLS tylko z przemiennikami w Polsce.

http://przemienniki.net/export/rxf.xml?country=cz,sk&source=all - wygeneruje nam plik XML z przemiennikami czeskimi i słowackimi

http://przemienniki.net/export/chirp.csv?latitude=52.231957&longitude=21.006129&range=20&band=2m,70cm - wygeneruje nam plik dla Chirpa, z przemiennikami pasm 2m i 70cm znajdujące się w promieniu 20 kilometrów od Pałacu Kultury i Nauki w Warszawie.

Format natywny

Główne drzewo pilku XML zawiera się w tagach <rxf> ... </rxf>. Poza polami opisującymi podstawowe informacje jak data aktualizacji spisu czy data wygenerowania zawiera dwa zestawy informacji: słownik (dictionary) i listę przemienników (repeaters). Słownik zawiera listę atrybutów każdego przemiennika, czyli dostępne wartości pól "status", "band" (pasmo pracy), "mode" (typ przemiennika), "activation" (sposób aktywowania przemiennika). Każdy taki atrybut ma unikalną w ramach typu atrybutów wartość będącą pojedyńczym bitem. Dzięki temu, w polach które mogą mieć na raz kilka wartości (wszystkie poza "status") wstawia się po prostu sumę wartości atrybutów. Dla przykładu, przemiennik będący jednocześnie przemiennikiem DSTAR i FM ma wartość w polu mode 36 (32+4). Wbrew pozorom, wyszukiwanie dzięki takim wartościom z punktu widzenia programistycznego jest banalnie proste i polega na przeprowadzeniu operacji "and" na wartościach. Oczywiście, poza tak skomplikowanym zapisem, w rekordzie przemiennika są także normalne wartości opisowe.

Przykładowa definicja przemiennika w pliku XML wygląda tak:

<repeater>
        <qra>SR5TEST</qra>
        <id>8996912</id>
        <hash>fa7929c5bb73997ed0fe252b8c23e3d9</hash>
        <created>2012-03-15 13:02:42</created>
        <updated>2012-03-15 13:02:42</updated>
        <statusInt>1</statusInt>
        <status>WORKING</status>
        <licenseExpiryDate>2017-01-01</licenseExpiryDate>
        <modeInt>4</modeInt>
        <mode>FM</mode>
        <bandInt>4096</bandInt>
        <band>2M</band>
        <qrg type="rx">145.100000</qrg>
        <qrg type="tx">145.700000</qrg>
        <country>pl</country>
        <qth><![CDATA[Warszawa PKiN]]></qth>
        <location>
	        <locator>KO02MF</locator>
        	<latitude>52.231716</latitude>
	        <longitude>21.006031</longitude>
        	<altitudeOverSea>117</altitudeOverSea>
	        <altitudeOverGround>80</altitudeOverGround>
        </location>
        <activationInt>16672</activationInt>
        <activation>1750</activation>
        <activation>CTCSS</activation>
        <activation>DTMF</activation>
        <ctcss type="rx">131.8</ctcss>
        <ctcss type="tx">146.2</ctcss>
        <dtmf type="rx">*</dtmf>
        <trxPower>10.00</trxPower>
        <operator>SP1ABC</operator>
        <operator>SP5DEF</operator>
        <echolink>3183277</echolink>
        <remarks><![CDATA[Przemiennik klubu SP5XYZ]]></remarks>
        <link>http://przemienniki.net/przemienniki/2m/SR5TEST</link>
        <link>http://www.sp5xyz.pl/przemiennik_sr5test</link>
        <source>http://przemienniki.net</source>
        <feedback>http://przemienniki.net/zglos/8996912</feedback>
</repeater>

Omówmy kolejne pola:

Gorąco radzę weryfikować wersję pliku w nagłówku i w przypadku zmiany od razu zapoznać się z poniższą stroną ;-)

Ta strona używa ciasteczek do przechowywania ustawień i zliczania unikalnych użytkowników. Korzystamy także z programów Google Analytics i AdSense. Możesz zawsze wyłączyć ciasteczka w konfiguracji swojej przeglądarki. Dowiedz się więcej » Zamknij [X]