Výškopis České republiky
Příklad s mapou Google arrow Dokumentace Neděle, 05 září 2010

Hlavní menu
Příklad s mapou Google
Příklad s mapou Atlasu
Příklad s mapou Seznamu
- - - - - - -
Popis služby
Dokumentace
Získání klíče
Fórum
Napište nám
English pages
- - - - - - -
Dokumentace PDF Tisk E-mail
Napsal Administrator   
Pondělí, 14 květen 2007

Po registraci obdržíte klíč, který použijete jako parametr pro získání API. Příklad:

      <script type="text/javascript" src="http://vyskopis.cz/api/getapi_v1.php?key=SRGBSWMYESLRCNP"></script>

 

 V případě úspěšného získání API budete mít k dispozici následující fukce:

    topoToFeets( meters ) - převod délek z metrů na stopy

    topoParseAngle( string ) - převede kombinovaný zápis zeměpisné délky nebo šířky na desetinné číslo.

    topoGetAltitude( lat, lon, action, context, timeout ) - dotáže se serveru na nadmořskou výšku místa s GPS souřadnicemi (lat,lon), při příchodu odpovědi zavolá událost  "action" a jako parametr jí předá zjištěnou výšku. Context je volitelný parametr, pokud jej zadáte, tak je předáván jako druhý parametr do události "action". Tento mechanismus umožňuje efektivnější alokaci paměti než při použití inline funkcí. Timeout je volitelný parametr, udává maximální dobu v milisekundách, kterou se čeká na odpověď serveru. Po vypršení timeout je volána událost "action", jíž je místo nadmořské výšky předán "null". Pokud timeout není zadán, pak k zavolání "action" nemusí dojít.

    topoGetAltitudes( quadruples, timeout ) - provede hromadný dotaz na server. "Quadruples" je pole čtveřic, každá čtveřice se skládá z "lat", "lon", "action" a volitelně "context" - viz popis parametrů topoGetAltitude(). Čtveřice jsou rozděleny na skupiny po maximálně 280, každá skupina je zaslána jako jeden dotaz.

  topoComputeDistance( lat1, lon1, lat2, lon2 ) - vypočítá vzdálenost v km mezi místem o GPS souřadnicích (lat1,lon1) a místem o GPS souřadnicích (lat2,lon2). Výpočet je proveden na straně klienta. Bere se v úvahu zakřivení zemského povrchu.

  topoComputeIntermediate( lat1, lon1, lat2, lon2 , fraction ) - vrátí pole obsahující souřadnice místa, které se nachází na cestě mezi místem o GPS souřadnicích (lat1,lon1) a místem o GPS souřadnicích (lat2,lon2). "Fraction" udává relativní pozici místa, například 0.5 znamená místo v polovině mezi oběma místy. Výpočet je proveden na straně klienta. Bere se v úvahu zakřivení zemského povrchu.

  topoDrawGraph( divElement, coordinates, width, height, english ) - vykreslí výškový profil cesty procházející místy, jejichž souřadnice (lat,lon) jsou prvky pole "coordinates". "DivElement" je odkaz na HTML element typu "DIV", do kterého je vložen serverem vytvořený obrázek typu PNG o rozměrech daných volitelnými parametry width a height. Implicitní rozměr je 600x250. Novinka: english je volitelný parametr, který přepne jednotky z metry+kilometry na stopy+míle.

 

Pro ukázky zdrojových kódů doporučujeme otevřít některý z následujících příkladů:

http://www.vyskopis.cz/demo/google.html

http://www.vyskopis.cz/demo/atlas.html

http://www.vyskopis.cz/demo/seznam.html

Aktualizováno ( Sobota, 13 září 2008 )