Ak chcete na vašich internetových stránkach zobrazovať odkaz na našu aplikáciu www.cp.sk, používajte k tomu nasledujúci kód:

Ak chcete vašim užívateľom ponúknuť väčší komfort tak, že sa zobrazí predvyplnený formulár (prípadne priamo výsledky vyhľadávania) alebo ak si chcete uľahčiť prácu pri používaní aplikácie (nemusieť vyplňovať stále rovnaké hodnoty), môžete k tomu použiť nižšie uvedené možnosti.

Aplikácia pracuje s tzv. "peknými" URL adresami, takže k prístupu k jednotlivým cestovným poriadkom slúži vždy názov daného cestovného poriadku alebo kombinácie (bez diakritiky).

Príklad:

Obdobne k prístupu k jednotlivým záložkám slúži názov záložky (bez diakritiky), takže je možné použiť nasledujúci zoznam kľúčových slov:

• spojenie
• odchody
• zcp (iba s cestovným poriadkom MHD - pokiaľ nebude žiadny vybratý, použije sa Bratislava)
• spoje (iba s cestovným poriadkom MHD - pokiaľ nebude žiadny vybratý, použije sa Bratislava)

Obidva postupy je možné kombinovať, takže napríklad ak chcete použiť cestovný poriadok MHD Žilina a záložku Zastávkové CP, použite adresu http://www.cp.sk/zilina/zcp/, a pod.

Východzím cestovným poriadkom je kombinácia Vlaky + Autobusy, za predpokladu, že aplikácia nebola ešte nikdy použitá. V opačnom prípade je východzím cestovným poriadkom ten cestovný poriadok, ktorý bol naposledy použitý pri poslednom prístupe k aplikácii. Východziou záložkou je záložka Spojenie.

Predvyplniť (a prípadne odoslať) je možné iba formuláre, u ktorých to má zmysel, tzn. Spojenie, Odchody a Zastávkové CP.

Pre zadávanie parameterov odkazu platia nasledujúce pravidlá:

• na poradí parameterov nezáleží,
• u parameterov sa nerozlišuje veľkosť písmen,
• všetky parametere sú nepovinné,
• aplikácia očakáva vstupné parametere v kódovaní UTF-8,viď tabuľka prekódovania
  
  

  Znak	Prekódovanie	Znak	Prekódovanie
  á	%C3%A1	Á	%C3%81
  ä	%C3%A4	Ä	%C3%84
  č	%C4%8D	Č	%C4%8C
  ď	%C4%8F	Ď	%C4%8E
  é	%C3%A9	É	%C3%89
  ě	%C4%9B	Ě	%C4%9A
  í	%C3%AD	Í	%C3%8D
  ĺ	%C4%BA	Ĺ	%C4%B9
  ľ	%C4%BE	Ľ	%C4%BD
  ň	%C5%88	Ň	%C5%87
  ó	%C3%B3	Ó	%C3%93
  ô	%C3%B4	Ô	%C3%94
  ŕ	%C5%95	Ŕ	%C5%94
  ř	%C5%99	Ř	%C5%98
  š	%C5%A1	Š	%C5%A0
  ť	%C5%A5	Ť	%C5%A4
  ú	%C3%BA	Ú	%C3%9A
  ů	%C5%AF	Ů	%C5%AE
  ý	%C3%BD	Ý	%C3%9D
  ž	%C5%BE	Ž	%C5%BD

  
  skryť tabuľku prekódovania
  
  
• ak potrebujete predvyplniť text obsahujúci medzeru, nahraďte v kóde odkazu túto medzeru reťazcom %20 alebo znakom + (napr. "hlavná stanica" je možné zapísať ako hlavn%C3%A1%20stanica alebo ako hlavn%C3%A1+stanica),
• pre prepnutie na rozšírené zadanie slúži parameter af=true,
• pre voľbu jazyka aplikácie slúži parameter lng=jazyk (kde položka jazyk môže nadobúdať hodnoty S (Slovenčina), E (Angličtina) a G (Nemčina)),
• pre odoslanie zadaných parameterov vo všetkých nižšie uvedených príkladoch slúži parameter submit=true.

Vo všetkých formulároch (v ktorých to má zmysel) je možné predvyplniť položky Odkiaľ, Kam a Prestup alebo Cez. Na ich predvyplnenie slúžia nasledujúce parametere:

položka Odkiaľ

parameter f=text (v rozšírenom zadaní možnosť zadať viac objektov oddelených bodkočiarkou, maximálne 3)

položka Kam

parameter t=text (v rozšírenom zadaní možnosť zadať viac objektov oddelených bodkočiarkou, maximálne 3)

položka Prestup

parameter ch=text (je možné zadať viac objektov oddelených bodkočiarkou, maximálne 3, nieje možné kombinovať s parameterom v=)

položka Cez

parameter v=text (možnosť zadať viac objektov oddelených bodkočiarkou, maximálne 3, nieje možné kombinovať s parameterom ch=, nieje možné použiť v jednoduchom zadaní)

Pre voľbu typu zadávaného objektu (zadanie mena z kategórie vs. adresný bod) slúžia následujúce parametere:

voľba typu zadávaného objektu v položke Odkiaľ

parameter fs=

voľba typu zadávaného objektu v položke Kam

parameter ts=

voľba typu zadávaného objektu v položke Prestup

parameter chs= (nieje možné kombinovať s parameterom vs=)

voľba typu zadávaného objektu v položke Cez

parameter vs= (nieje možné kombinovať s parameterom chs=)

parametre môžu nadobúdať iba dvoch hodnôt (v prípade zadania viacerých objektov sa hodnoty pre jednotlivé objekty oddelujú bodkočiarkou):

Zadanie mena z kategórie (východzí typ zadania)

hodnota 0 (nula)

Zadanie mena adresného bodu

hodnota 1 (jednotka)

Ak je nastavený typ zadávaného objektu voľbou z kategórie (viď viššie), je možné pre jednotlivé položky zvoliť konkrétnu kategóriu zadávaného objektu. K tomuto účelu slúžia nasledujúce parametere (v prípade zadania viacerých objektov sa hodnoty pre jednotlivé objekty oddelujú bodkočiarkou):

pre nastavenie kategórie pre položku Odkiaľ

parameter fc=

pre nastavenie kategórie pre položku Kam

parameter tc=

pre nastavenie kategórie pre položku Prestup

parameter chc=text (nieje možné kombinovať s parameterom vc=)

pre nastavenie kategórie pre položku Cez

parameter vc=text (nieje možné kombinovať s parameterom chc=)

Hodnotami uvedených parameterov sú čísla jednotlivých kategórií, ktoré sú uvedené v tabuľke kategórií.

Ak je nastavený typ zadávaného objektu voľbou z kategórie (viď viššie), je možné zadať priamo geografické súradnice. Formát zadávania je "predpona: zemepisná šírka@zemepisná dĺžka". Podporované soúradnicové systémy sú:

K odkazu na formulár pre vyhľadávanie spojení slúži adresa http://www.cp.sk/spojenie/ v prípadnej kombinácii s názvom cestovného poriadku (viď vyššie).

Vo formulári je možné predvyplniť následujúce údaje:

položky Odkiaľ, Kam a Prestup

viď voľba zadávaného objektu

položka Dátum

parameter date=dátum (kde dátum by mal byť v tvare d.m.rrrr v rozsahu platnosti použitého cestovného poriadku alebo kombinácie cestovných poriadkov)

položka Čas

parameter time=čas (kde čas by mal byť v tvare h:mm)

prepínač Príchod

parameter byarr=true (pri zapnutom prepínači sa bude hľadať podľa času príchodu, vo východzom stave je prepínač v polohe Odchody - bude sa hľadať podľa času odchodu)

prepínač Len priame spojenia

parameter direct=true (vo východzom stave je prepínač vypnutý)

V rozšírenom zadaní naviac platí:

položky Odkiaľ, Kam a Prestup alebo Cez

viď voľba zadávaného objektu

položka Maximálny počet prestupov

parameter mch=číslo (kde číslo musí byť číslo v intervale od 1 do 10)

položka Maximálna dĺžka presunu

parameter ma=číslo (kde číslo musí byť z množiny (0, 5, 10, 20, 30, 45, 60)

položka Maximálna dĺžka presunu, ak ide o MHD

parameter mac=číslo (kde číslo musí byť z množiny (0, 5, 10, 20, 30, 45, 60)

položka Maximálny presun na zač./konci

parameter maf=číslo (kde číslo musí byť z množiny (0, 5, 10, 20, 30, 45, 60)

položka Používať presuny iba medzi zastávkami rovnakého mena

parameter lwa=true

položka Preferovať vlaky pred autobusmi

parameter pt=true

položka Preferovať frekventované trasy

parameter as=true

Pre odkaz používajte nasledujúci kód:

Príklad použitia:

Odkaz http://www.cp.sk/vlakbus/spojenie/?f=%C5%BDilina&t=Bratislava predvyplní formulár hodnotou Žilina v položke Odkiaľ a hodnotou Bratislava v položke Kam. Bude zvolená kombinácia Vlaky + Autobusy.

Ako odkaz na formulár pre vyhľadávanie odchodov/príchodov slúži adresa http://www.cp.sk/odchody/, prípadne v kombinácii s názvom cestovného poriadku (viď vyššie).

Vo formulári je možné predvyplniť nasledujúce údaje:

položky Odkiaľ a/alebo Kam

viď volba zadávaného objektu

položka Dátum

parameter date=dátum (kde dátum by mal byť v tvare d.m.rrrr v rozsahu platnosti použitého cestovného poriadku či kombinácie cestovných poriadkov)

položka Čas

parameter time=čas (kde čas by mal byť v tvare h:mm)

prepínač Príchod

parameter byarr=true (pri zapnutom prepínači sa bude hľadať podľa času príchodu, vo východzom stave je prepínač v polohe Odchody - bude se hľadať podľa času odchodu)

prepínač Bez obmedzení

parameter nolimit=true (vo východzom stave je prepínač vypnutý)

Pre odkaz používajte následujúci kód:

Príklad použitia:

Odkaz http://www.cp.sk/vlakbus/odchody/?f=Bansk%C3%A1+Bystrica predvyplní formulár hodnotou Košice v položke Odkiaľ. Bude zvolená kombinácia Vlaky + Autobusy.

Ako odkaz na formulár pre vyhľadávanie zastávkových cestovných poriadkov MHD (tzv. vývesiek) slúži adresa http://www.cp.sk/zcp/.

Pre správne fungovanie odkazu doporučujeme nastaviť cestovný poriadok typu MHD. Ak nebude žiadny nastaveý alebo ak bude nastavený nejaký iný typ cestovného poriadku, kombinácie, alebo chybná hodnota, použije sa vždy MHD Bratislava.

Vo formulári je možné predvyplniť nasledujúce údaje:

položka Linka

parameter l=linka

položky Odkiaľ a Kam

viď voľba zadávaného objektu

položka Dátum

parameter date=dátum (kde dátum by mal byť v tvare d.m.rrrr v rozsahu platnosti použitého cestovného poriadku)

prepínač Celý týždeň

parameter wholeweek=true (vo východzom stave je prepínač vypnutý)

Pre odkaz používajte nasledujúci kód:

Odkaz http://www.cp.sk/bratislava/zcp/?l=147&f=Slavin&t=Kozia predvyplní formulár hodnotou 147 v položke Linka, hodnotou Slavín v položke Odkiaľ a hodnotou Kozia v položke Kam. Zároveň sa predvolí cestovný poriadok MHD Bratislava.

Vyššie uvedené možnosti využitia odkazu na www.cp.sk sú bezplatné, ale nesmú byť porušené podmienky využívania aplikácie CP (viď šepkár k aplikácii).

Pri využití možnosti iba žiadame o umiestnenie nášho loga s odkazom na náš web na vaše stránky. Pre vloženie nášho loga na vaše stránky použite kód pre vloženie loga INPROP.

V prípade, že sa rozhodnete vyššie popísaný postupu využiť, žiadame Vás o poslanie informačnej správy o použití postupu (spolu s informáciou o internetovej adrese vašej webovej prezentácie) na adresu cis@inprop.sk.