Mitä?
Helsingin Sanomat julkaisee omakaupunki.hs.fi -sivuston meno- ja palvelutiedot avoimena rajapintana.
Rajapinta julkaistaan 10.10. järjestettävää HS Open #3 -tilaisuutta varten, mutta myös muuhun käyttöön.
Missä?
Rajapinnan kuvaus ja käyttöohjeet ladattavissa tästä. Itse rajapinta löytyy osoitteesta api.omakaupunki.fi
Lisenssi?
Rajapinnan kautta välitettävät tiedot julkaistaan lisenssillä Creative Commons nimeä-epäkaupallinen-tarttuva 3.0.
Lisäksi rajapinnan käyttöön tarvitaan salasana. HS Openin osallistujille salasana lähetetään mahdollisimman pian. Muut voivat pyytää käyttölupaa Vesa Lindqvistiltä tällä lomakkeella. Jos haluatte kysyä jotain, Vesa Lindqvist vastaa osoitteessa vesa.lindqvist@sanoma.fi
Huomioitavaa?
Jos teette jonkin sovelluksen rajapinnan kautta, pyydämme kertomaan siitä tämän blogin kommenteissa tai sähköpostitse. Tarjoamme kehittäjille myös mahdollisuutta saada näkyvyyttä sovelluksilleen HS Labs -ohjelman kautta.
Mahdolliset sovellukset kannattaa myös ilmoittaa Apps4Finland-kilpailuun 23.10. mennessä.
Lähetä palautetta
Tämä on rajapinnan ja dokumentaation ensimmäinen versio. Jos joku on epäselvää tai toimii toisin kuin on määritelty, otamme mielellämme palautetta vastaan. Ja korjaamme puutteita tarvittaessa.
EDIT 21.10.: Rajapinnan kuvausta päivitetty, linkki osoittaa Omakaupunki.fi:n sivulle.
9. lokakuuta 2011 kello 20.43
Onko rajapinta jo toiminnassa. API-avain löytyy, mutta juttelu aiheuttaa: {”code”: 999, ”error”: ”Unexpected error”}
9. lokakuuta 2011 kello 20.50
Epäilemättä asiasta on käyty keskustelua…
CC -lisenssi, hienoa!
Epäkaupallinen ja tarttuva, ei niin hienoa.
Epäkaupallinen ei käytännössä ole raastuvassa testattu, että toimiiko ylipäätään, sillä ”kaupallisen” määritelmä häilyvä (ääriesimerkki, voiko cc-epäkaupallinen -kamaa julkaista blogissa, jossa on Google-mainospalkki?). Tarttuva taas tekee datasta huonosti yhteensopivan, kun miksataan muiden datasettien kanssa.
Uskoakseni Hesari hyötyy jokatapauksessa siitä, että Omakaupunki -dataa hyödynnetään laajasti. Toivottavasti suuntana on jatkossa puhdas CC-By.
9. lokakuuta 2011 kello 21.14
Petri: Kyllä se API on ainakin viime viikolla toiminut ilman ongelmia. Ja kokeilin juuri: toimii ilman mitään ongelmaa.
Maanantaina HS Openissa on paikalla API:n molemmat kehittäjät, joten niiltä voinee tiedustella sitten asiaa tarkemmin.
9. lokakuuta 2011 kello 21.33
Esimerkiksi menotietoja kokoaa ja toimittaa Hesarissa monta palkattua ihmistä. Ne on meille tärkeä kaupallinen tuote. Siinä mielessä tällaiseen rajapintaan CC-epäkaupallinen-nimeä-tarttuva tuntuu juuri oikealta lisenssiltä.
Jos joku haluaa kehitellä liiketoimintaa tuon rajapinnan tai muiden meidän matskujen päälle, meillä on kyllä tarjolla parempia sopimusmalleja. Ne eivät ole sitten enää CC-lisenssejä, vaan tapauskohtaisesti sovittavia asioita. Talon sisällä niitä kutsutaan HS Labs -sopimuksiksi ja niitä voi tiedustella Vesa Lindqvistiltä (@sanoma.fi). Yritän saada tästä asiasta parempaa tietoa tähän blogiin, kunhan vain saataisiin nämä muut projektit ensin alta pois.
Jos katsoo kansainvälisiä esimerkkejä, niin Guardianilla on kolmiportainen malli oikeuksiin (http://www.guardian.co.uk/open-platform/what-is-the-open-platform). Se on mielenkiintoinen tapa hoitaa asia.
9. lokakuuta 2011 kello 21.45
Nyt toimii. Ehkä kyseessä oli jokin väliaikainen häiriö tai ehkä sössin jotakin itse.
10. lokakuuta 2011 kello 11.09
Koetin tavata API dokumentaatiota: onko tuossa sijaintitiedot mukana? Koordinaatit tai osoitteet?
10. lokakuuta 2011 kello 11.12
Ja korjaus edelliseen, kyllähän vastauksissa esiintyy lat ja lon. Oletuksena voi varmaan pitää, että ne ovat WGS84 koordinaatteja.
Tämähän käy mielenkiintoiseksi.
10. lokakuuta 2011 kello 14.00
Käsityksemme mukaan tuota standardia. Kehittäjät täsmentävät vielä.
10. lokakuuta 2011 kello 14.35
@PekkaS: WGS84 koordinaatteja.
13. lokakuuta 2011 kello 12.23
[...] Helsingin Sanomat on aloittanut omien tietovarastojensa avaamisen. Lähimpänä paikkatietoja ovat Omakaupungin meno- ja palvelutiedot. Tiedon avaamisen lisäksi Helsingin Sanomat on käsitykseni mukaan ensimmäisenä mediatalona [...]
24. lokakuuta 2011 kello 10.44
Meidän Oma kaupunki API -tekeleemme löytyy osoitteesta http://cs.helsinki.fi/group/ihana/.
26. lokakuuta 2011 kello 11.17
Ei se ole mikään tekele! Se on hieno lisätty todellisuus -palikka. Suosittelen tutustumaan.
27. lokakuuta 2011 kello 14.43
Olen käyttänyt tätä Omakaupungin palveludataa Hätäopas-sovelluksessa:
http://demo.seco.tkk.fi/hataopas/
http://www.apps4finland.fi/fi/kilpailutyot/sovellus-hataopas
Keräsin APIn kautta saatavat palvelutiedot ja muunsin ne RDF-formaattiin. Jouduin tekemään aika paljon putsailuja ja korjailuja datalle, koska etenkin kotisivujen URL:t olivat usein pielessä tai omituisesti ilmaistu. Osan näistä (pahimmat tapaukset) olen myös korjannut suoraan Oma kaupunki -palveluun. Myös puhelinnumerot vaativat putsausta, ja osoitteet olen pilkkonut osiin (katuosoite, postinumero, toimipaikka).
Valmis data on julkaistu, kts.
http://www.apps4finland.fi/fi/kilpailutyot/datan-avaus-palvelupistedataa-palvelukartasta-omakaupunki-fi-sta-ja-palveluvaaasta
8. marraskuuta 2011 kello 14.58
[...] kaupunkiin Idea: Mistä löytyy lähin vessa, lääkäri ja apteekki -mobiilipalvelu Data: Omakaupunki.fi:n palvelutiedot, HRI:n julkaisema kaupungin palvelukartta Tekijät: Osma [...]
4. joulukuuta 2011 kello 20.01
Hei
Avoimen lähdekoodin Wandorassa on nyt Oma kaupunki-rajapintalouhija. Helppokäyttöinen louhija muuntaa Oma kaupunki -datan topic map -muotoon. Louhittua dataa voi edelleen jalostaa ja visualisoida Wandoralla. Siihen voi esimerkiksi yhdistää HRI-dataa.
Louhijan esittely löytyy osoitteesta
http://www.wandora.org/wandora/wiki/index.php?title=Oma_kaupunki_extractor