GSFleet-yhteys tuo linkitettyjen laitteiden sijainteja ja matkamittarilukemia automaattisesti GSFleetistä Spotillan Spoteille. Voit ottaa sijaintien päivityksen, matkamittarien päivityksen tai molemmat käyttöön. Sijainnin päivittyminen ja lukutapahtuman syntyminen ovat eri asioita: Spotin sijainti voi muuttua ilman uutta lukutapahtumaa.

Käyttöönoton edellytykset

GSFleet-ominaisuuden on oltava käytössä organisaatiollasi. Yhteyden asetukset ja laitelinkitykset tehdään selainpalvelussa adminkäyttäjän oikeuksilla. Linkitettävään Spottiin tarvitaan muokkausoikeus, ja Spotilla on oltava tagi, jolla on sisäinen tunnus. Poistettuun Spottiin ei voi luoda linkitystä. Katso tarvittaessa tagin liittäminen Spottiin.

Tarvitset GSFleetin API-avaimen, jolla käytettävät laitteet ovat saatavilla. Jos GSFleet ei näy integraatioissa, katso integraation käyttöönoton edellytykset.

Tallenna ja tarkista yhteys

  1. Avaa selainpalvelun navigaatiosta Palvelun asetukset → Integraatiot → GSFleet.
  2. Avaa Tunnistautuminen, syötä API-avain ja valitse Tallenna. Tallennus tarkistaa yhteyden GSFleetiin. Epäonnistunut tarkistus ei tallenna uusia tunnistetietoja.
  3. Voit tarkistaa tallennetun avaimen myöhemmin painamalla Testaa yhteys. Onnistunut testi päivittää tiedon Viimeksi vahvistettu onnistuneesti.

Yhteystesti tarkistaa pääsyn GSFleetin laiteluetteloon. Se ei vielä vahvista, että tietyn laitteen sijainti tai matkamittarilukema olisi päivittynyt Spottiin.

Ympäristö-valikossa näkyvät Tuotanto ja Sandbox. GSFleet-yhteys käyttää kummallakin valinnalla samaa palvelua. Sandbox-valinta ei estä Spotin tietojen muuttumista, jos päivitykset ovat käytössä.

Linkitä laite ja valitse päivitettävät tiedot

  1. Avaa GSFleetin Asetukset ja kohdan Spottien synkronointi painike Linkitetyt laitteet.
  2. Valitse Linkitä uusi laite. Valitse Spotilla-spotti ja kohdasta Valitse laite sitä vastaava GSFleet-laite. Laitteen tunnistamista helpottavat esimerkiksi nimi, rekisteritunnus, sarjanumero ja IMEI, jos GSFleet palauttaa nämä tiedot.
  3. Vahvista valitsemalla Linkitä uusi laite. Yhteen Spottiin voi linkittää yhden GSFleet-laitteen, ja sama GSFleet-laite voi olla linkitettynä vain yhteen Spottiin.
  4. Valitse Spottien synkronointi -kohdassa tarvitsemasi päivitykset: Päivitä Spotillan sijainnit GSFleetistä, Päivitä Spotillan matkamittarilukemat GSFleetistä tai molemmat.
  5. Jos otat matkamittaripäivityksen käyttöön, valitse kohdassa Matkamittarin ominaisuus (km) käytettävissä oleva numeerinen ominaisuus. Varmista, että sama ominaisuus on jokaisella Spotilla, jonka lukeman haluat päivittää. Puuttuvaa ominaisuutta ei luoda automaattisesti. Tallenna asetukset.

Ominaisuusvalinta on yhteinen linkitetyille laitteille. Jos kenttä puuttuu Spotilta, katso Spotin tietojen muokkaaminen. Kansion laitekortti voi määrätä, mitä kenttiä Spotilla on; sen muuttaminen voi vaikuttaa muihinkin Spotteihin.

Automaattinen päivitys on ajastettu noin 10 minuutin välein. Linkitys ei itsessään hae tietoja heti. Päivittyminen riippuu myös tausta-ajon valmistumisesta ja GSFleetin palauttamista tiedoista.

Miten matkamittarilukema tallentuu?

GSFleetin palauttama matkamittarilukema tallennetaan valittuun Spotin ominaisuuteen kilometreinä. Se on matkamittarin lukema, ei käyttötuntilukema eikä GPS-pisteistä laskettu kuljettu matka. Palautetun luvun on oltava kelvollinen, äärellinen ja suurempi kuin 1. Luku jaetaan tuhannella ja pyöristetään kolmeen desimaaliin: esimerkiksi 12345 tallentuu arvona 12,345 km.

Tyhjä ominaisuusarvo täytetään. Olemassa oleva arvo korvataan vain, jos muunnettu ja pyöristetty lukema on sitä suurempi. Sama tai pienempi lukema ei muuta arvoa. Jos aiempi arvo ei ole kelvollinen numero, päivitys ohitetaan; tarkista ja korjaa arvo tarvittaessa Spotilla. Päivitys muuttaa olemassa olevaa ominaisuusarvoa, jonka muutoksista säilyy historiaa. Katso tietokenttien historia.

Matkamittarin päivitys ei tarvitse kelvollista tai uutta GPS-sijaintia. Matkamittarilukeman mukana ei käytetä GPS-mittausaikaa, joten tallennettu arvo tai ajon lokimerkintä ei yksin kerro lukeman mittausaikaa.

Miten sijainti ja lukutapahtumat päivittyvät?

Kun sijaintipäivitys on käytössä, synkronointi hakee kunkin linkitetyn laitteen sijainnin. Hyväksytty sijainti korvaa Spotin tallennetut koordinaatit, myös aiemmin käsin asetetun sijainnin. Androidissa ja iOS:ssä voit avata Spotin tiedoista Sijainti-näkymän kartalle. Androidin laiteluettelossa sijainti voi näkyä nimellä Kiinteä sijainti, koska koordinaatit on tallennettu Spottiin. Tämä nimitys ei tarkoita, että GSFleet-päivitykset olisivat pysähtyneet.

  • Ensimmäinen hyväksytty sijainti tallentaa sijainnin ja alustaa liikkeen vertailupisteen. Siitä ei synny lukutapahtumaa.
  • Uudempi sijaintitieto päivittää Spotin koordinaatit, jos ne ovat muuttuneet. Muuttumattomasta sijainnista ei synny lukutapahtumaa.
  • Yli 50 metrin etäisyys vertailupisteestä synnyttää lukutapahtuman. Vertailupiste vaihtuu tällöin uuden tapahtuman sijaintiin. Ennen ensimmäistä tapahtumaa vertailupisteenä on alustuksessa tallennettu sijainti.

Esimerkiksi laite siirtyy ensin 30 metriä ja sitten samaan suuntaan vielä 30 metriä. Ensimmäinen päivitys muuttaa sijaintia ilman lukutapahtumaa. Kun uusi sijainti on 60 metrin päässä vertailupisteestä, syntyy lukutapahtuma. Etäisyys lasketaan koordinaattipisteiden väliltä, ei kuljettuna matkana. Tasan 50 metriä ei riitä.

GSFleetin synnyttämä lukutapahtuma on automaattinen: siihen ei liity mobiilikäyttäjää eikä se edellytä tagin fyysistä lukemista. Tapahtuman aika on Spotillaan kirjaamisen aika, ei GSFleetin mittausaika. Tapahtumaan tallentuvat laitteen koordinaatit. Katso myös lukutapahtumien tarkastelu kartalla.

Tarkista tulos ja selvitä puuttuva päivitys

Tarkista ensimmäisen ajon jälkeen oikean Spotin valittu ominaisuus ja vertaa lukemaa GSFleetin tietoihin. Sijaintipäivityksessä tarkista myös Spotin sijainti kartalla. Avaa selaimessa Palvelun asetukset → Integraatiot → GSFleet → Integraatioloki ja etsi ajon yhteenveto. Se kertoo muun muassa päivitettyjen sijaintien ja lukutapahtumien määrät sekä matkamittarien päivitetyt, muuttumattomat, ohitetut ja virheelliset käsittelyt. Yhteenveto koskee koko ajoa, joten tarkista myös yksittäisen Spotin tieto. Katso integraation virheen selvittäminen lokista.

Jos matkamittari ei päivity, tarkista päivitysvalinta, oikea laitelinkitys ja valitun numeerisen ominaisuuden olemassaolo Spotilla. Tarkista myös GSFleetin palauttama lukema ja Spotilla mahdollisesti oleva suurempi tai virheellinen arvo.

Sijainti hyväksytään vain, jos siinä on kelvolliset koordinaatit ja mittausaika. Puuttuva tai virheellinen tieto ohitetaan. Alustuksen jälkeen myös samaa mittausaikaa oleva tai aiempaa vanhempi tieto ohitetaan. Spotillan sijainti jää silloin ennalleen; karttapiste ei yksin takaa laitteen tämänhetkistä sijaintia. Synkronointi ei tuo laitteelta täydellistä kulkureittiä tai kaikkia välissä syntyneitä mittauksia.

Spotin tilat Ei käytössä ja Viallinen eivät pysäytä sijainnin tai matkamittarin päivitystä. Yhteysvirhe voi estää yksittäisen laitteen päivityksen. Tunnistautumisvirhe, GSFleetin pyyntörajan ylittyminen tai kolme peräkkäistä tilapäistä virhettä saman tyyppisissä sijainti- tai matkamittaripyynnöissä keskeyttävät ajokerran jäljellä olevan käsittelyn. Tunnistautumisvirheen jälkeen automaattiset haut pysähtyvät, kunnes tunnistetiedot on vahvistettu uudelleen onnistuneella tallennuksella tai yhteystestillä.

Keskeyttäminen ja linkityksen poistaminen

Tilapäinen keskeytys: poista Spottien synkronointi -kohdassa sen päivityksen valinta, jonka haluat pysäyttää, ja tallenna. Sijaintivalinnan poistaminen ei pysäytä matkamittaria eikä päinvastoin. Pysäytä molemmat poistamalla molemmat valinnat. Linkitykset, viimeiset arvot ja lukutapahtumat säilyvät. Kun otat sijaintipäivityksen takaisin käyttöön, liikkeen vertailu jatkuu aiemmasta vertailupisteestä.

Yhden linkityksen purkaminen: avaa Linkitetyt laitteet, paina rivin roskakorikuvaketta ja vahvista. Tämä pysäyttää molemmat päivitykset kyseiseltä laitteelta ja poistaa laitteen ja Spotin välisen linkityksen. Se ei poista Spottia, GSFleet-laitetta, Spotin viimeistä sijaintia, ominaisuusarvoa tai aiempia lukutapahtumia ja ominaisuushistoriaa. Voit tämän jälkeen linkittää laitteen tai Spotin uudelleen. Uusi linkitys alustaa sijaintiseurannan alusta.

Spotin muuttaminen tilaan Poistettu poistaa sen GSFleet-linkityksen automaattisesti. Spotin palauttaminen käyttöön ei palauta linkitystä, vaan se täytyy tehdä uudelleen.

Yhteyden poistaminen käytöstä: pura ensin kaikki GSFleet-laitelinkitykset. Valitse sen jälkeen Tunnistautuminen-välilehdellä Tyhjennä tallennetut tunnistetiedot. Toiminto poistaa GSFleetin tallennetun API-avaimen ja molempien päivitysten asetukset. Spottien sijainnit, ominaisuusarvot ja aiemmat tapahtumat säilyvät.