Spørsmål · Adresser

Hvordan legger jeg til autofullføring av adresser i skjemaet mitt?

Hva den som fyller ut, ser

Brukeren skriver «karl johans» og ser «Karl Johans gate», med stedene der gaten finnes; er poststedet allerede fylt ut, snevres forslagene inn til det. Når gaten er valgt, skriver brukeren husnummeret, og skjemaet sier om det finnes: i de store byene er det husnummeret som avgjør postnummeret, og postnummeret som kommer er det riktige for akkurat det nummeret, ikke et generelt for stedet.

Ved valget fylles feltene for adresse, postnummer og poststed ut med oppføringen som har gått gjennom motoren, den samme som i adressekontrollen. Registeret blir rent fra starten i stedet for å måtte ryddes etterpå.

Slik betales det

Per økt, ikke per tastetrykk. Forslagsforespørslene mens brukeren skriver er gratis; det telles én behandling når brukeren velger adressen og feltene fylles ut. Endrer brukeren deretter husnummeret og velger på nytt i samme økt, betales det ikke igjen. Hver økt tillater opptil tretti forespørsler og varer i ti minutter. Prislisten står på prissiden.

Slik integreres den

Tre deler:

1. Et API-token, fra kontoen din.
2. En liten proxy på din egen server, en side som tar imot forespørselen fra nettleseren, legger til tokenet og sender den videre til vårt endepunkt. Den trengs fordi tokenet aldri skal ligge i kode som kjører i nettleseren.
3. Widgeten ra-suggerisci.js, uten avhengigheter: du oppgir adressen til proxyen og velgerne for feltene i skjemaet, og den gjør resten: den håndterer selv ventetiden mens brukeren skriver, konteksten fra feltene som allerede er fylt ut, og utfyllingen ved valget.

Den som heller vil gjøre det selv, kaller endepunktet /api/v1/suggest direkte: en økt-ID generert av klienten, teksten som er skrevet, feltene som allerede er kjent som kontekst; deretter valghandlingen med den valgte gaten og husnummeret. Alt står i API-dokumentasjonen.

Særtilfeller

• Andre land: forslagene finnes i alle land med adresseregister i drift (listen); skjemaet sender landet brukeren har valgt, og widgeten søker der, med husnummerets og postnummerets form i det landet. Brukeren kan skrive alt i ett felt («Kalverstraat 92 Amsterdam»): svaret sier hvordan det ble lest (parsed: gate, husnummer, postnummer). I et land uten register sier svaret det og åpner ingen økt: utfyllingen fortsetter for hånd, uten at noe trekkes. Sverige følger så snart tilgangen til det svenske registeret er på plass.
• WooCommerce og PrestaShop: du trenger ikke skrive noe, det finnes pluginen for WooCommerce og modulen for PrestaShop med autofullføring i kassen og kontroll av ordrene.
• Gate som ikke dukker opp: brukeren kan alltid skrive hele adressen selv; oppføringen går gjennom kontrollen senere, fra filen eller fra API-et.
• Flere skjemaer, flere nettsteder: samme token betjener alle skjemaene; proxyen kan ligge på hvert nettsted eller være felles.

Hva som skjer med feltene

Gaten fullføres i korrekt form, bokstaven i husnummeret blir stor og skrives inntil, poststedet settes med store bokstaver, og postnummeret settes av motoren. I de store byene kommer postnummeret for akkurat det husnummeret.