Skip to content

hackenbruder/govdata-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GovData Javascript SDK

See English version

Oficiální javascriptové SDK podporující prohlížeče a Node.js.

Build Status

GovData

GovData poskytují vybraná OpenData prostřednictvím API a zjednodušují jejich integraci do aplikací pomocí SDK. Otevřená data, API, SDK a aplikace tvoří ekosystém a kvalitní aplikace mohou vznikat pouze ve fungujícím ekosystému. Naše SDK jsou pokryta testy a služby jsou vysoce dostupné.

Poskytována jsou data ze živnostenského, obchodního a dalších rejstříků, včetně registru plátců daně z přidané hodnoty. Data jsou standardizována a je v nich možné vyhledávat.

Vyzkoušejte si zdarma naši službu a SDK.

Instalace

Prohlížeče

Nejsnadnější instalaci SDK do prohlížeče můžete provést vložením následujících tagů do HTML kódu vaší stránky:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.0/jquery.min.js"></script>
<script src="https://s3-eu-west-1.amazonaws.com/cdn.govdata.cz/js/govdata-1.0.8.min.js"></script>

Knihovnu také můžete instalovat lokálně na váš server a načítat jako vlastní javascript. Podporujeme knihovnu Require.js. SDK po instalaci vytváří jediný globální objekt GovData nebo window.GovData.

Node.js

SDK nainstalujete standardním příkazem:

npm install govdata

Volání require vrací jediný objekt.

Konfigurace

SDK je dodáváno předkonfigurované jako demo s příslušným klíčem a limity. Tuto konfiguraci je možné využít k otestování naší služby a při vývoji vaší aplikace.

Konfigurace SDK pro produkční použití se provádí voláním metody init na objektu GovData:

GovData.init({ stage: '<hodnota>', key: '<hodnota>' });

Použití

Jednoduché hledání

Vyhledání subjektu v obchodním rejstříku:

GovData.findEntityByNumber('00006947',
	function(entity) {
		console.info('Název:', entity.getName());
	},
	function(error) {
		console.error(error.toString());
	}
);

Podrobnější příklad můžete najít zde.

Geoprostorové hledání

Vyhledání subjektů pomocí GPS souřadnic a rádiusu:

GovData.findEntitiesByGeo(50.08915042002743, 14.407195183397297, 100, 1,
    function(response) {
        console.info('Počet stránek:', response.getPages());
        console.info('Počet výsledků na aktuální stránce:', response.getCount());

        var results = response.getResults();
        for(var i = 0; i < results.length; ++i) {
            var r = results[i];
            console.info('Identifikační číslo:', r.getNumber(), 'Název:', r.getName());
        }
    },
    function(error) {
        console.error(error.toString());
    }
);

Dokumentace

Dokumentace objektů v SDK se připravuje. Dostupné objekty a jejich metody si můžete prohlédnout v souboru govdata.coffee.

Licence

MIT