Oficiální javascriptové SDK podporující prohlížeče a Node.js.
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.
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.
SDK nainstalujete standardním příkazem:
npm install govdata
Volání require vrací jediný objekt.
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>' });
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.
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 objektů v SDK se připravuje. Dostupné objekty a jejich metody si můžete prohlédnout v souboru govdata.coffee.