Spørgsmål · Adresser

Hvordan tilføjer jeg autocomplete af adresser til min formular?

Hvad den, der udfylder, ser

Brugeren skriver »rådhusplads« og ser »Rådhuspladsen« med de postbyer, hvor den vej findes; er byen allerede udfyldt, indsnævres forslagene til den. Når vejen er valgt, skriver brugeren husnummeret, og formularen siger, om det findes: postnummeret, der kommer, er det, der hører til netop det nummer, ikke et gæt ud fra bynavnet, og i København er det nummeret, der afgør, om det er »København V« eller »København K«.

Ved valget udfyldes felterne vej, husnummer, postnummer og by med posten, som motoren har verificeret, den samme som ved adresseverificeringen. Registret fødes rent i stedet for at skulle ryddes op bagefter.

Sådan betales det

Pr. session, ikke pr. tastetryk. Forslagene, mens der skrives, er gratis; der tælles én behandling, når brugeren vælger adressen, og felterne udfyldes. Ændrer brugeren derefter husnummeret og vælger igen i samme session, betales der ikke igen. Hver session tillader op til tredive kald og gælder i ti minutter. Prislisten står på siden Priser.

Sådan integreres den

Tre dele:

1. En API-token fra dit kontoområde.
2. En lille proxy på din server, en side, der modtager kaldet fra browseren, tilføjer din token og sender det videre til vores endpoint. Den skal bruges, fordi din token aldrig må ligge i den kode, der kører i browseren.
3. Widgetten ra-suggerisci.js, uden afhængigheder: du angiver proxyens adresse og selektorerne for felterne i formularen, og den klarer resten: ventetiden, mens der skrives, konteksten fra de felter, der allerede er udfyldt, og udfyldningen ved valget.

Vil du hellere gøre det selv, kalder du endpointet /api/v1/suggest direkte: et sessions-id genereret af klienten, den skrevne tekst, de allerede kendte felter som kontekst; derefter valghandlingen med den valgte vej og husnummeret. Det hele står i API-dokumentationen og i OpenAPI-specifikationen.

Særlige tilfælde

• Andre lande: forslagene findes i alle lande, hvis nationale adresseregister er i drift (listen); formularen sender det land, brugeren har valgt, og widgetten søger dér, med det lands form for husnummer og postnummer. Brugeren kan skrive det hele i ét felt (»Karl Johans gate 22 Oslo«): svaret siger, hvordan det blev læst (parsed: vej, husnummer, postnummer). I et land uden register siger svaret det og åbner ingen session: udfyldningen fortsætter i hånden, uden at der trækkes noget.
• WooCommerce og PrestaShop: der skal ikke skrives noget, der findes pluginet til WooCommerce og modulet til PrestaShop med autocomplete i kassen og verificering af ordrerne.
• En vej, der ikke dukker op: brugeren kan altid skrive hele adressen selv; posten kan verificeres senere, fra en fil eller fra API'et.
• Flere formularer, flere websites: den samme token betjener alle formularer; proxyen kan ligge på hvert website eller være fælles.

Hvad der sker med felterne

Vejen fuldføres i registrets form, husnummeret verificeret, postnummeret sat af motoren ud fra netop det nummer: brugeren har ikke skrevet det. Postbyen med store bogstaver, som posten vil have den.