Tampereen kaupunki - www.tampere.fi


Etusivu Palveluhakemisto Yhteystiedot Tampere-info RSS

Etusivu
Tampere-info
Viestintä
Internet
RSS-syötteet ja rajapinnat
Ohjeet

Normaali versio

Ohjeet

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

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.

Sivun alkuun

RSS-rajapintojen käyttö

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:

  • Eri tietolähteistä on mahdollista saada kooste ilman että joutuu käymään lukuisilla eri nettisivulla. Pystyt esimerkiksi lisäämään omalle sivullesi tiedotteet, ilman lämpötilan, avoimet työpaikat ja vaikka yhdistyksesi tapahtumakalenterin. Tiedot ovat aina ajan tasalla, kun RSS-lähteen tarjoaja päivittää niitä.
  • Esitysmuodon voi valita mielensä mukaisesti, koska sitä ei ole määritelty etukäteen. Voit muuttaa vaikkapa tekstikoon ja värimaailman mielesi mukaisiksi.
  • Eri päätelaitteita varten ei tarvitse tehdä eri versioita samasta tiedosta. Samaa sisältöä voidaan jakaa niin nykyisiin kuin tuleviinkin laitteisiin.
  • 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-lukijat

    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 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)

    Sivun alkuun

    Tiedon sisällyttäminen omalle sivulle

    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>

    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.

    Sivun alkuun

    Lisätietoa

    Tampereen kaupunki käyttää RSS-rajapintoja omassa toiminnassaan. Yhdessä paikassa ylläpidettyjä tietoja jaetaan useaan eri kohteeseen RSS-rajapintojen kautta www-sivuille ja mobiilipalveluihin.

    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

    Sivun alkuun

    Linkit

    » Feedreader
    Ilmainen RSS-lukijaohjelma
    http://sourceforge.net/projects/feedreader/

    » SharpReader
    Ilmainen RSS-lukuohjelma
    http://www.sharpreader.net/

    » Tampereen kaupungin RSS-lukija ja ohjeita
    Voit selailla kaupungin RSS-feedien sisältöä www-pohjaisella RSS-lukijalla
    http://www.tampereenkaupunki.com/rss/lukija

    » XML 10 kohdan tiivistelmänä
    W3-konsortion kymmenkohtainen lista siitä, mitä XML on.
    http://www.w3c.tut.fi/translations/xml/xmlin10pts/

    » Jouni Heikniemi: Mikä on XML?
    Suomenkielinen johdanto XML:ään.
    http://www.heikniemi.net/kirj/moxml.html

    » W3C - Extensible Markup Language (XML)
    W3-konsortion johdatus XML-kieleen (englanninkielinen)
    http://www.w3.org/XML/

    » RSS 2.0 Specification
    Harvardin yliopiston Berkman Centerin ylläpitämä helppolukuinen RSS-spesifikaatio
    http://blogs.law.harvard.edu/tech/rss



    http://www.tampere.fi/tampereinfo/viestinta/internet/rajapinnat/ohjeet.html
    Päivitetty 16.10.2013
    © Tampereen kaupunki 2014