Trimble Feedback Mobile app ja rajapinnat Kuvaus

Table of Contents ii (13) Table of Contents 1.1 -integraatio Trimble TerraFle maastotyösovellukseen... 3 1.2, App ja ulkoinen rajapinta... 5 1.2.1 Rajapinta kolmansien osapuolien käyttöön... 5 1.3, Open 311 liityntä... 7 1.3.1 Service discovery... 8 1.3.2 GET Service List... 8 1.3.3 GET Service Definition... 9 1.3.4 POST Service Request... 10 1.3.5 GET service_request_id from a token... 11 1.3.6 GET Service Requests... 11 1.3.7 GET Service Request... 12

3 (13) 1.1 -integraatio Trimble TerraFle maastotyösovellukseen -palautteet voidaan nyt siirtää maastotyöntekijöiden käsiteltäväksi. Maastoon siirretyt palautteet latautuvat automaattisesti Trimble TerraFle-sovellukseen, jossa on monipuoliset maastotyötä tukevat ominaisuudet. TerraFle-sovellusta voidaan käyttää Trimblen laitteilla Geo 6000, Geo 7, Juno 3/5, Yuma2 sekä iphone ja Android laitteilla. TerraFle tukee myös Trimblen Pro 6T ja 6H sekä R1 GNSS-vastaanottimia. Maastossa tarkastettu ja kuitattu työ palautuu -ohjelmaan raportointia ja jatkotyöstöä varten. Käsittelijä voi siirtää palauteen TerraFleiin lisäämällä palautteella toimenpiteen Lähetä TerraFleiin ja osoittaa palautteen TerraFleorganisaation käyttäjälle Palautteen lähettäminen TerraFleiin. TerraFleissä palaute näkyy uutena Taskina, jonka käyttäjä voi ottaa käsittelyyn. Alkuperäisestä palautteesta TerraFleiin lähetetään sijainti, selitys, käsittelijän lisäämä lisätieto ja palautteen sisältämä kuva. TerraFleistä Feedbackiin välittyy maasto kommentti ja kuva sekä tila korjattu/ei korjattu.

4 (13) Palautteen käsittely TerraFle Android clientilla. Integraatiossa toimii aktiivisena osapuolena, myös palautteiden palautuksessa maastosta Feedbackiin. Palautus on toteutettu TeklaWebAgent- pluginilla. -integraatio Trimble TerraFle maastotyösovellukseen edellyttää TerraFle Advanced lisenssin hankintaa.

5 (13) 1.2, App ja ulkoinen rajapinta Palautteen antoon kehitetty App, jolla voidaan antaa palautetta älypuhelimilla. Tuetut järjestelmät ovat ios 6, Android 2.3.3 ja Windows Phone 8 ja uudemmat. App on käyttäjälle ilmainen ja löytyy sovelluskaupoista nimellä. Palautteen anto mahdollisimman yksinkertaista: App selvittää laitteen sijainnin ja näyttää sijainnin mukaan mitä Trimblen Palautepalveluita on sijainnin mukaisessa paikassa Käyttäjä valitsee yhden Palautepalvelun Käyttäjä ottaa kuvan ongelmakohdasta Käyttäjä kirjoittaa tekstimuotoisen kuvauksen ongelmasta ja täydentää yhteystiedot niin halutessaan Käyttäjä lähettää palautteen Palautteet välittyvät eri järjestelmiin sijainnin ja käyttäjän valitseman palvelun mukaan Palautteet tallentuvat palvelukohtaisesti valittuun palautetyyppiin/aiheeseen Appin tuetut kielet ovat suomi, ruotsi, englanti ja saksa Appin toiminnot. 1.2.1 Rajapinta kolmansien osapuolien käyttöön Mahdollistaa asiakkaan haluamien kolmansien osapuolen sovellusten lähettää palautetta asiakkaan palautejärjestelmään. Saapuneiden palautteiden käsittely tapahtuu saman prosessin ja käyttöliittymän kautta kuin muut palautteet. Rest-tyyppinen rajapinta, jossa kommunikointi JSON:lla. Rajapinta on versioitu tulevien muutosten hallitsemiseksi. Tukee useita rajapintaversioita.

6 (13) Nimi Esimerkki Pakollisuus Tyyppi Huom! Language fi-fi Vapaaehtoinen String(5) Description Reikä tiessä. Pakollinen String(65535) Party/firstname Matti Vapaaehtoinen String(1024) Party/surname Meikäläinen Vapaaehtoinen String(1024) Party/email Matti.meikalai nen@gmail.c om Location/description Risteys Vapaaehtoinen String(1024) Vapaaehtoinen String(65535) Email formaatti Location/lat 60.18649372 Pakollinen Double, range(-90-90) WGS 84 (EPSG:4326) Location/lon 24.80619725 Pakollinen Double, range(-180-180) WGS 84 (EPSG:4326) Location/accuracy 25 Vapaaehtoinen Double, range(0, 10000000) Attachments/name Kuva.png Pakollinen String(1024) Attachments/conten t_type Attachments/conten t image/png Pakollinen String(65535) ivborw0kggoaaaansuheugaaabaaaaaqa QMAAAAlPW0iAAAABlBMVEUAAAD///+l2Z/dA AAAM0lEQVR4nGP4/5/h/1+G/58ZDrAz3D/McH 8yw83NDDeNGe4Ug9C9zwz3gVLMDA/A6P9/A FGGFyjOXZtQAAAAAElFTkSuQmCC Pakollinen base64 encoded content ma ~4mb Rajapinnan v1 tukema sisältö.

7 (13) 1.3, Open 311 liityntä voi olla yhteydessä ulkoisiin järjestelmiin Open311- rajapinnan kautta. Open311 on teknologia, joka tarjoaa avoimen viestintäkanavan julkisia tiloja ja palveluita koskeville asioille. http://www.open311.org/ Rajapinnan kuvaus on saatavilla service discovery -menetelmän kautta. Open311:tä voi käyttää vain julkisten palautteiden siirtoon, jotka on lisätty tai haettu ulkoisen järjestelmän kautta. tukee GeoReport API v2:ta palautteiden tarkastelemiseen ja syöttämiseen. Vain pakolliset osat sisältyvät toteutukseen. http://wiki.open311.org/georeport_v2/ Rajapinnan määrittelyt tehdään Hallinta-osiossa. Samasta palvelusta voidaan julkaista eri palautetyyppejä eri organisaatioille. Julkaisu rajapintaan voidaan tehdä Tyyppi-aihe kohtaisesti. Palautteiden tilojen kytkentä 311 standardiin tehdään koodiston ohjausarvoilla. Rajapinnan määrittely Hallinta-osiossa.

8 (13) 1.3.1 Service discovery Eample request: http://test.trimblefeedback.com/api/georeport/discovery.ml Eample response: 1.3.2 GET Service List Request jurisdiction_id services service service_name description metadata Response type keywords - group - Eample: http://demosite.trimblefeedback.com/efeedback- 311/api/georeport/v2/services.ml?jurisdiction_id=trimble palauttaa aina false, koska metadatat ei käytössä. palauttaa aina realtime

9 (13) 1.3.3 GET Service Definition Request jurisdiction_id Response service_definition attributes - attribute - variable - code - datatype - required - datatype_description - order - description - values - value - key - name - Ainoastaan tämä palautetaan, sillä metadata-ominaisuutta ei ole tuettu Eample: http://demosite.trimblefeedback.com/efeedback- 311/api/georeport/v2/services/1ef69635-2040-e511-a68b- 005056a675dc.ml?jurisdiction_id=trimble

10 (13) 1.3.4 POST Service Request Request jurisdiction_id location parameter attribute - lat lon address_string - address_id - email device_id - account_id - first_name last_name phone - description media_url - Response service_requests request servicerequest_id token - Ei tuettu, sillä vaihtoehtoinen servicerequest_id:n kanssa service_notice TUETTU, palauttaa kiitos palautteestaviestin account_id - Eample request created with Fiddler:

11 (13) POST: http://test.trimblefeedback.com/api/georeport/v2/requests.ml Content-Type: application/-www-form-urlencoded; charset=utf-8 Host: test.trimblefeedback.com api_key=usiwlzmh6fqk2buopvz53et5vpeorss&jurisdiction_id=trimble&= b619e390-9892-e511-a553-005056a675dc&lat=37.76524078&long=- 122.4212043&description=open311+POST+test&first_name=Mikko&last_name=Viitala&e mail=mikko.viitala@trimble.com Eample response: 1.3.5 GET service_request_id from a token Not supported 1.3.6 GET Service Requests Request

12 (13) jurisdiction_id servicerequest_id start_date end_date status Response service_requests request servicerequest_id status status_notes - service_name description agency_responsible - service_notice - requested_datetime updated_datetime epected_datetime - address - address_id - zipcode - lat lon Eample request: http://test.trimblefeedback.com/api/georeport/v2/requests.ml?jurisdiction_id=trimble&start_ date=2015-01-01t00:00:00z&end_date=2016-08-11t00:00:00z&status=open Eample response: 1.3.7 GET Service Request Request

13 (13) jurisdiction_id servicerequest_id Response service_requests request servicerequest_id status status_notes - service_name description agency_responsible - service_notice - requested_datetime updated_datetime epected_datetime - address - address_id - zipcode - lat lon Eample request: http://test.trimblefeedback.com/api/georeport/v2/requests/576.ml?jurisdiction_id=trimble Eample response: