API

Chcete-li využít API, musíte být registrovaný odběratel (nebo veřejný odběratel, ale s omezeným celkovým limitem dotazů dle zatíženosti serveru). O registraci můžete požádat ve formuláři nížě.

Koncept API:

Všechny souřadnice se zadávají v decimální podobě. Generování oveřovacího řetězce TOKEN viz níže.

Dotaz pro seznam všech oblastí:

http://c.adamslo.net/getLocations.php?token=TOKEN

Dotaz pro seznam oblastí v zadaném reqionu

http://c.adamslo.net/getLocations.php?token=TOKEN&x1=X1&y1=Y1&x2=X2&y2=Y2

Dotaz pro data jedné oblasti skal:

http://c.adamslo.net/getLocation.php?token=TOKEN&location=ID_LOKACE

Generování tokenu (PHP,Java,JavaScript):

Po registraci obdržíte 2 řetězce. Jeden je bezpečně náhodný řetězec, druhý je heslo k přístupu. Token vygenerujete následovně:

BASE_64_ENCODED(AES_256(md5(NáhodnéČíslo1)+"."+BEZPECNY_NAHODNY_RETEZEC+"."+POČET_SEKUND_OD_1_1_1970+"."+md5(NáhodnéČíslo2),HESLO))

md5(NáhodnéČíslo1) a md5(NáhodnéČíslo2) se musí lišit
POČET_SEKUND_OD_1_1_1970 je GMT
platnost dotazu je jedna minuta, tzn. POČET_SEKUND_OD_1_1_1970+60

Pokud TOKEN není zadán, využíváte veřejného limitu. Ten je nastaven dle vytížení serveru! V takovém případě není nezbytná registrace ale není tak zaručeno, že dostanete data. STATUS pole pak obsahuje OUT_OF_PUBLIC_LIMIT.

Použítí JavaScript dotazu je vázáno na doménu a nepotřebuje TOKEN.

Formát odpovědí:

Odpověd pro seznam oblastí:

{
"status":"STATUS",
"locations":[
["NÁZEV_LOKACE_1",GPSY1,GPSX1,ID_LOKACE_1,"SOUŘADNICE_HMS1"],
["NÁZEV_LOKACE_2",GPSY2,GPSX2,ID_LOKACE_ID2,"SOUŘADNICE_HMS2"],
...,
["NÁZEV_LOKACE_N",GPSYN,GPSXN,ID_LOKACE_IDN,"SOUŘADNICE_HMSN"]
],
}

Odpověd pro data jedné oblasti:

{
"status":"STATUS",
"title":"NÁZEV",
"description":"POPIS",
"latitude":ZEMĚPISNÁ_ŠÍŘKA,
"longitude":ZEMĚPISNÁ_DÉLKA,
"latitudeLongitudeHMS":"SOUŘADNICE_JAKO_ŘETĚZEC_HODINA_MINUTA_VTERINA",
"guideLink":"ODKAZ_NA_PRŮVODCE",
"map":"ODKAZ_NA_MAPKU",
"locations":[
["NÁZEV_PODLOKACE_1",GPSY1,GPSX1,ID1,"SOUŘADNICE_HMS1"],
["NÁZEV_PODLOKACE_2",GPSY2,GPSX2,ID2,"SOUŘADNICE_HMS2"],
...,
["NÁZEV_PODLOKACE_N",GPSYN,GPSXN,IDN,"SOUŘADNICE_HMSN"]
],
"images":["OBRÁZEK_1","OBRÁZEK_1",...,"OBRÁZEK_N"]
}

Možná pole STATUS:

OK - vrácena platná data
INVALID_RECTANGLE - zadané ohraničení oblasti nebylo platné
NO_TOKEN - token nebyl odeslán
INVALID_TOKEN - neplatný řetězec TOKEN
TOKEN_TIMEOUT - vypršela platnost tokenu
NO_SUCH_LOCATION - oblast nenalezena
OUT_OF_LIMIT - vyčerpán počet dotazů za den
OUT_OF_PUBLIC_LIMIT - na serveru byl vyčerpán limit pro veřejné dotazy

API