citysdk helsinki dev meetup 04.06.2012

HelsinkiSmartCity

Open interfaces Open data

City Service Development Kit

Whatever makes developer life easier

City as a platform

My background: HelMet bookscanner• Downloaded HelMet library catalog of 600000 titles (193MB)• Library locations from Helsinki Service MapNow API for data, library locations, even opening hours

HelMet bookscanner

Catalog: Helsinki Region Infosharewww.hri.fi

https://www.facebook.com/helsinkiregioninfoshare

Example: Helsinki metropolitan area service map REST API

Helsinki metropolitan area service map REST API

http://www.hel.fi/palvelukarttaws/rest/ver2_en.html

• 8600 Units / Locations

• 1130 service categories

• 226000 REST requests in May 2012

http://www.hel.fi/palvelukartta/Default.aspx?language=en&city=91

Public transport: ReittiGPS

https://sites.google.com/site/reittigps/

HSL developer pages

http://developer.reittiopas.fi/pages/en/home.php

Public transport: Mapnificent

ParkkiNappi / ParkMan

Parking payment machines

http://www.arcgis.com/home/item.html?id=368c48e20bb6498d8455f356aaa0fc74

Created: Antti Ahola

Traffic accidents

http://www.hri.fi/fi/sovellukset/helsingin-liikenneonnettomuudet-kartalla/

Suomenkuvalehti: Lauri Vanhala

Population density

http://www.hsy.fi/seututieto/kaupunki/paikkatiedot/Sivut/Avoindata.aspx

Ihana Helsinki!

Ihana Helsinki!

Summary• Helsinki very committed on openness and

developers• If you are looking for data, APIs and feedback =>

Go to Helsinki Region Infoshare www.hri.fi• Tell us how we can serve you better?

– Contact: jaakko.rajaniemi@hel.fi

• Other info from Facebook:– Helsinki Region Infoshare https://www.facebook.com/helsinkiregioninfoshare– CitySDK Helsinki https://www.facebook.com/CitySDKHelsinki– Finnish Open Data Ecosystem https://www.facebook.com/groups/fi.okfn/– AppsFinland https://www.facebook.com/Apps4Finland

CitySDK - Helsinki

Smart Participation – Lead Pilot in HelsinkiSmart Participation – Lead Pilot in Helsinki

Interfaces and processes developed during the project.

FVH coordinates

ASPA feedback handling system

Helsinki, HKR

Palauteydin,feedback coreHelsinki, Titek

Oma kaupunkiservice

Sanoma Oyj

Technology, software platforms

www.hel.fi

Fillarikanava

CityDepartment B

CityDepartment C

CityDepartment D

Citizen

ProcessesFacebook

Media XYBest practises

Piloted in the CitySDK project.

Smart Participation – CitySDK Helsinki

FixMyStreet - UK

Citizens Connect - Boston

Street Bump - Boston

Public works departmentannual feedback

Calls 63920Offered calls 86038Answered calls 63920

Customer visits 22 980Emails 25412 Together 112 312

Motivation for Open311

• It is the only standard in this area.• It is used in several cities in USA.• It has quite an active community behind.

It’s good enough and has potential to become globally used standard.

http://www.open311.org/

Supported use cases

• Use case 1: Submitting a service request• Use case 2: Quering individual service request• Use case 3: Quering service requests• Use case 4: Listing service request types• Use case 5: Mobility of user

Use case 1: Submitting a service request• Service request can be submitted with following info:

– Description and title– Location (not obligatory)

• lat/long (WGS-84), address, City specific data identiying service request object , e.g. Helsinki Service Map

– Service request type– Contact information

• Name, e-mail address, phonenumber, Account_id

– Device_id– Media attachment

• Photo and possibly other document formats

– Web link to external service where service request originates (e.g. Omakaupunki)– PROPOSED: Priority of the service request, Geometry (e.g. lines, polygons)

• Response includes– Service request id– Web link to city’s own web page where service request is published– PROPOSED: related_service_request_id

Parameters we want but not in Open311 spec.Parameters proposed but our support still open.Parameters we want but not in Open311 spec.Parameters proposed but our support still open.

Use case 2: Quering individual service request

• Individual service request can be queried using service request identification ID. Response includes:

– Description and title– Location

• lat/long (WGS-84), address, City specific data identiying service request object , e.g. Helsinki Service Map

– State (open, closed)• PROPOSED: Option to have more status values

– Response text– Submission date and time– Update date and time– Expected date and time when fixed– Government agency responsible for the service request

• PROPOSED: Option to have multiple agencies

– Service request type– URL address of attachment– PROPOSED: Priority of the service request, Geometry (e.g. lines, polygons)

Parameters we want but not in Open311 spec.Parameters proposed but our support still open.Parameters we want but not in Open311 spec.Parameters proposed but our support still open.

Use case 3: Quering service requests• Service requests can be queried

– Submission date and time (start and endtime)– Location (bounding box and/or lat/long+radius)– Status (all, closed or open)– Service request type(s)– Service request id(s)

• Response includes:– Description and title– Location

• lat/long (WGS-84), address, City specific data identiying service request object , e.g. Helsinki Service Map

– State (open, closed)• PROPOSED: Option to have more status values

– Response text– Submission date and time– Update date and time– Expected date and time when fixed– Government agency responsible for the service request

• PROPOSED: Option to have multiple agencies

– Service request type– URL address of attachments– PROPOSED: Priority of the service request, Geometry (e.g. lines, polygons)

Parameters we want but not in Open311 spec.Parameters proposed but our support still open.Parameters we want but not in Open311 spec.Parameters proposed but our support still open.

Use case 4: Listing service request types

• Clients can query list of service request types which are supported by the city.– Name of service request type– Description of service request type– Group of service request type

Use case 5: Mobility of service user

• Users may move between cities (Helsinki, Espoo or Barcelona) and use application to submit service requests.

• Service requests are routed to the correct city endpoint without the help of the user. – No solution yet.– We try to have solution which is compliant with Open311 standard– Solution may no have any impact on service request interface

Use cases under consideration

• Commenting on service requests• Editing and removing service requests• Account handling for users • Voting for service requests

We need your help

• We need your help to make citizen participation

– easier– better and more accurate– activate and excite more citizens– FUN!

We need developer feedback (1/2)• Media upload

– Support for photos and what else?– Synchronous Multipart/Form upload

• Types and groups of service requests– Different types like potholes, traffic signs, trash bins, parks, roads, parking, …– How to decide types and groups in the best way?

• Status values for service requests– Open, closed – New values needed?

• New location parameters– How to use Service Map unit ids as location parameter?

– service_request_object_type=http://www.hel.fi/palvelukarttaws/rest/ver2.html– service_request_object_id=12345

– Any use for more complex geomerty like lines and polygons?

We need developer feedback (2/2)• Mobility between cities

– How to detect where the user is and where to send service request?– Helsinki vs. Espoo vs. Vantaa

• Accurate address parameter– Manually typed addresses are not accurate– Lat,lon mapped to accurate address or some other mean to verify the address

• Push notifications on changes– Currently only pull model supported, enough?– Pull vs. Push model and how to do push notifications (e.g. Pubsubhubbub)

• How to use user identification parameters?– Current plan is not to have user accounts on city’s service– How to use device_id and author_id parameters?

Developer testing and usage• Test interface comes available later this year

– Enable debugging sent data and responses

• API key will be required for posting service requests– Some sort of validation needed for API key– This will be available next year

• Anyone interested to join effort to setup open source Open311 server for testing?

Next steps

• We want to build community around CitySDK topics => Join us on Facebook, events and elsewhere!

• The interface specification frozen in June => Please give feedback before.

• CitySDK schedule– Sanoma pilot beta ready in the end of this year– Test interface ready Q4

Contact info

• Jaakko.Rajaniemi@hel.fi ja Hanna.Niemi-Hugaerts@forumvirium.fi

• Puh: +358 40 516 5931• Twitter: @jaakko• Facebook:

https://www.facebook.com/CitySDKHelsinki