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

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

RSS-rajapintojen käyttö

Tiedon sisällyttäminen omalle sivulle

Lisätietoa

Linkit

 

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 kaupungin tapahtumat, ilman lämpötilan, tiedotteet 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.

    RSS-lukija feedreaderin ruudunkaappaus

    RSS-lukijat

    RSS-lukijan käyttö on yhtä helppoa kuin tavallisen nettiselaimenkin. Ohjelmaan tallennetaan RSS-osoitteet, ja se ilmoittaa automaattisesti, kun sisältö on muuttunut.

    Verkossa on sekä ilmaisia että maksullisia RSS-lukijoita. Ilmaisista suosittuja ovat esimerkiksi Sharpreader ja Feedreader. Myös Opera-selaimen 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.

    FeedReader-ohjelma

    OPML-tiedoston haku Feedreader-ohjelmaan.

    Esimerkiksi Feedreaderilla voit hakea OPML-listan seuraavalla tavalla (numerot viittaavat viereiseen kuvaan)

    • Valitse File - Import OPML-file.
    • Kopioi kenttään kaupungin OPML-tiedoston osoite (numero 1)www.tampere.fi/rss/rss_fi.opmlja paina nappia Display available feeds(2.)
    • Valitse kaikki tarjolla olevat RSS-sisällöt painamalla ensin Select all -nappia (3). Sen jälkeen paina nappia Set for selected feed (4) ja Import (5).
    • Hyväksy haetut RSS-sisällöt ja sulje ikkuna (6).
    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>

    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.

    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, digi-tv- ja mobiilipalveluihin.

    Tampereen kaupungin mobiilipalvelun rakennekaavio (ppt, 850 kb)

    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

    Sivun alkuun

    Linkit

    » Feedreader
    Monipuolinen, ilmainen RSS-lukijaohjelma
    http://sourceforge.net/projects/feedreader/


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


    » 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


    » What is OPML?
    Sivulla on kerrottu tarkemmin OPML:stä ja sen käytöstä (englanninkielinen).
    http://www.opml.org/


    » OGC-standardi
    http://www.opengis.org/docs/00-028.pdf