nobil

Nobil legger tilrette for bruk av ladestasjonsdataene som er registrert i databasen til Nobil, slik at nye og innovative tjenester ser dagens lys og fremmer bruken av elbil i Norge.

Hva er et API?
API står for Application Programming interface og er et stykke software som muliggjør bruk aveksisterende systemer for en 3. part.

Hvordan bruke klientapi-et til Nobil?
Vet å benytte httpkall med ulike parametre, kan tjeneste levere ladestasjondata tilbake til konsumenten.

Hva trengs?
Tjenesten som skal bruke apikall mot Nobil må registrere seg hos Nobil.no. Dataene som kreves forregistrering er som følger:
• Fornavn, etternavn
• Epost-adresse
• Mobilnummer
• Nettstedadresse (hvor tjenesten skal kjøre)
• Passord

Etter at registreringen er godkjent av Nobil.no vil man få tilsendt en API-nøkkel. Denne nøkkelenmå legges ved hver henvendelse (request) mot Nobils API. Dette for å identifisere hvem sombenytter seg av tjenesten og for å sikre Nobil.nos data og tjeneste.

API-nøkkelen er en tekststreng.For de som benytter seg av Googles API-er, er dette kjent stoff.For øyeblikket gjøres dette via henvendelse pr. epost til Nobil.no. Senere vil registrering, for å fåtilgang til API-et, være en automatisert prosess.


--------------------------------------------------------------------------------

Eksempel på hvordan dette kan gjøres via et Ajaxkall og jQuery:
jQuery.ajax({type: 'POST',url: 'http://nobil.no/api/server/search.php',data: {'apikey': nobilApiKey, 'apiversion': '1', 'action': "search", 'type': 'rectangle', 'northeast': (59.943921193288915, 10.826683044433594), 'southwest':(59.883683240905256, 10.650901794433594), 'existingids': '189,195,199,89,48'}, dataType: 'json'});

ParameterEksempel
verdiactionsearchapikeykey_du_har_mottatt_fra_Nobil.noapiversion1existingids
189,195,199,89,48,190,58,77,83,75,63,64,86,181,207,182,180

Liste med ladestasjon id-er som man ikke ønsker å hente ved ny forespørsel til server. Dette for å spare båndbredde og øke hastigheten på visningog navigasjon i f.eks et GoogleMaps kart. northeast(59.943921193288915, 10.826683044433594)southwest(59.883683240905256, 10.650901794433594)
--------------------------------------------------------------------------------

Page 4

Tjenesterespons ved kartutsnittsøk
Respons fra søketjenesten er av typen json-objekt. Eksempel på responsverdi fra server:[{"id":189,"navn":"DFDS til K\u00f8benhavn","adresse":"Vippetangen UtstikkerII","postnr":"0150","poststed":"OSLO","kommunenr":"0301","kommunenavn":"OSLO","
stedsbeskrivelse":"","plasstype_navn":"Parkeringshus","tilgjengelighet_navn":"Offentlig","eier
":"DFDSSeaways","antall_ladepunkter":2,"parkeringsavgift":false,"tidsbegrensing":12,"ladefart":"16A","
posisjon":"(59.90349,10.74334)","utbyggingstotte_navn":"Ingen","bilde":"189.jpg","ledigeplasser":2,"
kommentarbruker":"DFDS har lademuligheter forbiler p\u00e5 overfart til\/fra Danmark. Gi beskjed ved booking og tilmannskapet i fergen.","kontaktinfo":"Kundesenter 21 62 13 40","opprettet":"2010-03-2618:03:46","opprettetav_fornavn":"nobilAdmin","opprettetav_etternavn":"nobilAdmin","endret":"2010-03-2618:06:35","endretav_fornavn":"nobilAdmin","endretav_etternavn":"nobilAdmin","tilgang_navn":"
\u00c5pen","oslokommune_eierid":""}]

Eksempelimplementasjon
Demonstrasjon av eksempel finnes på lenken: http://www.nobil.no/api/client/search.phpEksempelets kildekoden kan hentes herfra: http://www.nobil.no/api/client/client.tar.gz