Näiden ohjeiden avulla pystyt hyödyntämään Tampereen kaupungin RSS-sisältöjä omalla koneellasi tai sivuillasi. Tutustu myös palvelun käyttöehtoihin.
Käyttöehdot koskevat sekä RSS-muodossa jaettavia sisältöjä että niiden liittämistä (iframe) osaksi omaa sivua. Ehtotekstissä käytetään termiä RSS-sisältö, joka kattaa molemmat käyttötavat.
Tampereen kaupungin RSS-sisältöjä saa käyttää yksityisillä sivuilla. Myös kaupallisilla sivuilla niiden käyttö on mahdollista, jos sisältö ei koostu pelkästään kaupungin tarjoamista RSS-aineistoista.
Tampereen kaupunki pyrkii takaamaan RSS-sisällön oikeellisuuden, mutta se ei kuitenkaan vastaa sisällössä mahdollisesti esiintyvistä epätarkkuuksista tai virheistä. Kaupunki ei myöskään sitoudu pitämään palveluita yllä samassa osoitteessa tai ympäristössä, eikä se vastaa muutosten mahdollisesti aiheuttamista virheistä, ongelmatilanteista tai niistä aiheutuneista välillisistä tai välittömistä kustannuksista.
Sopimuksen mukaan avattavia rajapintoja koskevat sopimuksessa määritellyt käyttöehdot.
RSS on standardoitu tapa esittää tietoa. Siinä ei määritellä mitään esitystapaan tai ulkoasuun liittyvää, joten XML-muodossa olevaa tietoa on helppo käsitellä ja jakaa eri kanaviin.
Perinteiseen nettisivuun verrattuna RSS-sisällössä on merkittäviä etuja sekä tiedon tuottajien että sen hyödyntäjien kannalta:
RSS-lyhenne tulee sanoista Rich Site Summary tai Really Simple Syndication. Rakenteisen tiedon esittämiseen tarkoitettu XML on puolestaan lyhenne sanoista Extensible Markup Language.
RSS-lähteen voi lukea omalla ohjelmalla (RSS-lukija) tai sen pystyy upottamaan osaksi omaa nettisivua. OPML-tiedoston avulla voidaan tuoda lukijaan yhdellä kerralla useita RSS-osoitteita. Esimerkiksi Tampereen kaupunki on koonnut kaikki tarjoamansa RSS-sisällöt OPML-tiedostoon.
Sivun alkuun
RSS-lukijan käyttö on yhtä helppoa kuin tavallisen nettiselaimenkin. Ohjelmaan tallennetaan RSS-osoitteet (linkki xml-tiedostoon), ja kun avaat lukuohjelman seuraavan kerran, se näyttää automaattisesti uudet sisältöpäivitykset kyseisestä syötteestä.
Verkossa on sekä ilmaisia että maksullisia RSS-lukijoita. Ilmaisista suosittuja ovat esimerkiksi Google, Sharpreader ja Feedreader. Myös selainten uusimmat versiot pystyvät näyttämään suoraan RSS-sisältöä. Muita lukuohjelmia löytyy esimerkiksi hakusanoilla "RSS reader download".
Voit tallentaa esimerkiksi kaikki Tampereen kaupungin tarjoamat RSS-sisällöt yhdellä kertaa, kun noudat OPML-listan lukijaasi. Tai voit valita vain yhden Sinua kiinnostavan syötteen ja tallentaa sen osoitteen lukijaasi.
Esimerkiksi Feedreaderilla voit hakea OPML-listan seuraavalla tavalla (numerot viittaavat viereiseen kuvaan)
Yksinkertaisin tapa liittää tietoja oman www-sivun osaksi on käyttää iframe-koodia. Kun kopioit alla olevan koodinpätkän, saat sivullesi tiedon Tampereen kaupungin avoimista työpaikoista.
<iframe src="http://www.tampereenkaupunki.com/mobiili/tyopaikat.php?iframe=1" scrolling="yes" width="400" height="400" frameborder="0" marginheight="0" marginwidth="0"> </iframe>
Voit valita myös muita aiheita:
Tiedotteet (otsikko ja alkukappale)
http://www.tampereenkaupunki.com/mobiili/tiedotus_tiedotteet.php?iframe=1
Tapahtumat
http://www.tampereenkaupunki.com/mobiili/tapahtumat.php?iframe=1
Koulujen ruokalistat
http://www.tampereenkaupunki.com/mobiili/kouluruoka.php?iframe=1
Päiväkotien ruokalistat
http://www.tampereenkaupunki.com/mobiili/pkruoka.php?iframe=1
Viinikanlahden sääasema
http://www.tampereenkaupunki.com/mobiili/viinikka.php?iframe=1
Uimavesien lämpötilat
http://www.tampereenkaupunki.com/mobiili/uima.php?iframe=1
Sijoita haluamasi osoite mallikoodissa olevan tilalle kohtaan
src="http://www.tampereenkaupunki.com/mobiili/tyopaikat.php?iframe=1"
Voit muokata myös muuta koodia.
Scrolling = vieritys. Jos liitetty sivu ei mahdu määriteltyjen kehysten sisään, sen alalaitaan ja vasemmalle laidalle tulee näkyviin vierityspalkit. Suositellaan käytettäväksi arvoa "yes".
Width = leveys, käytetyn kehyksen leveys pikseleinä. Oletusarvona 500px.
Height = korkeus, käytetyn kehyksen korkeus pikseleinä. Oletusarvona 400px.
Frameborder = kehyksen reunan paksuus pikseleinä. Oletusarvona 0px, ei reunaa.
Marginheight = kehyksen ylämarginaali. Oletusarvona 0, ei marginaalia.
Marginwidth = kehyksen sivumarginaali. Oletusarvona 0, ei marginaalia.
Voit käyttää upotuksessa myös omaa tyylitiedostoa. Vaihda silloin seuraavan esimerkin mukaisesti oma tyylitiedostosi verkko-osoite:
<iframe src="http://www.tampereenkaupunki.com/mobiili/tyopaikat.php?iframe=1 &css=http://www.tampere.fi/ekstrat/tyylit/iframe_rss_tyyli2.css"></iframe>
Katso myös upottamisen mallikoodeja.
Tiedon sisällyttäminen myös suoraan RSS-lähteestä on sallittua muutamin rajoituksin. Tiedon yhteydessä on näytettävä RSS-lähteen copyright ja link -kohtien sisältö. Tampereen kaupunki pidättää oikeuden estää RSS-lähteen käytön epäasiallisissa yhteyksissä tai silloin, jos liikennemäärä kasvaa kohtuuttomasti.
Tallenna tieto paikallisesti ja tarkista RSS-lähde esimerkiksi vartin välein.
Tampereen kaupunki käyttää RSS-rajapintoja omassa toiminnassaan. Yhdessä paikassa ylläpidettyjä tietoja jaetaan useaan eri kohteeseen RSS-rajapintojen kautta www-sivuille, digi-tv- ja mobiilipalveluihin.
Tampereen kaupungin mobiilipalvelun rakennekaavio
(ppt, 850 kt)
Tampereen kaupungin RSS-lukija ja ohjeita Voit selailla kaupungin RSS-sisältöä www-pohjaisella RSS-lukijalla. Mukana myös ohjeita ja esimerkkikoodi.
www.tampereenkaupunki.com/rss/lukija
Tampereen kaupungin karttarajapinnan testaussivu
Tarkoitettu palvelunkehittäjille testauskäyttöön. Varsinaiset rajapinnat avataan sopimuksesta.
www.tampere.fi/cgi-bin/kami/bp/tre_kartta