Spurningar · Heimilisföng

Hvernig bæti ég sjálfvirkri útfyllingu heimilisfanga við eyðublaðið mitt?

Hvað sá sem fyllir út sér

Hann skrifar „hafnarstr“ og sér „Hafnarstræti“ með stöðunum þar sem sú gata er til; hafi hann þegar fyllt inn staðinn þrengjast tillögurnar að honum. Þegar gatan er valin slær hann inn húsnúmerið og eyðublaðið segir honum hvort það er til: í Reykjavík er það hverfið sem ræður póstnúmerinu, og póstnúmerið sem kemur er það rétta fyrir það húsnúmer, ekki eitthvert póstnúmer borgarinnar.

Við val fyllast reitirnir gata, húsnúmer, póstnúmer og staður með færslunni úr vélinni, þeirri sömu og í sannprófun heimilisfanga. Skráin verður til hrein í stað þess að vera hreinsuð eftir á.

Hvernig er greitt

Fyrir hverja setu, ekki fyrir hvern áslátt. Tillögubeiðnir meðan skrifað er eru ókeypis; ein vinnsla telst þegar notandinn velur heimilisfangið og reitirnir fyllast. Breyti hann svo húsnúmerinu og velji aftur í sömu setu er ekki greitt á ný. Hver seta leyfir allt að þrjátíu beiðnir og gildir í tíu mínútur. Verðskráin er á verðsíðunni.

Hvernig það er tengt

Þrír hlutar:

1. API-tákn, af aðgangssvæðinu þínu.
2. Lítill milliþjónn á þínum eigin vefþjóni, síða sem tekur við beiðninni úr vafranum, bætir tákninu við og sendir hana áfram á endapunktinn okkar. Hann þarf vegna þess að táknið má aldrei standa í kóða sem keyrir í vafranum.
3. Viðmótseiningin ra-suggerisci.js, án ytri safna: þú segir henni slóð milliþjónsins og veljara reitanna í eyðublaðinu, og hún sér um rest: biðina meðan skrifað er, samhengið úr reitunum sem þegar eru fylltir og útfyllinguna við val.

Sá sem vill gera þetta sjálfur kallar beint á endapunktinn /api/v1/suggest: setuauðkenni sem biðlarinn býr til, textann sem sleginn var inn, reitina sem þegar eru þekktir sem samhengi; svo valaðgerðina með völdu götunni og húsnúmerinu. Allt er í API-skjöluninni og í OpenAPI-lýsingunni sem þar er vísað á.

Sértilvik

• Önnur lönd: tillögurnar eru til í hverju landi með heimilisfangaskrá í notkun (listinn); eyðublaðið sendir landið sem notandinn valdi og viðmótseiningin leitar þar, með formi húsnúmers og póstnúmers þess lands. Notandinn getur skrifað allt í einn reit („Kalverstraat 92 Amsterdam“): svarið segir hvernig það las hann (parsed: gata, húsnúmer, póstnúmer). Í landi án skrár segir svarið frá því og opnar enga setu: útfyllingin heldur áfram handvirkt, án gjalds.
• WooCommerce og PrestaShop: það þarf ekkert að skrifa, til eru WooCommerce-viðbótin og PrestaShop-einingin með sjálfvirkri útfyllingu í greiðsluferlinu og sannprófun pantana.
• Gata sem birtist ekki: notandinn getur alltaf skrifað heimilisfangið í heild; færslan fer í gegnum sannprófunina seinna, úr skjali eða í gegnum API.
• Fleiri eyðublöð, fleiri vefir: sama táknið þjónar öllum eyðublöðunum; milliþjónninn getur verið á hverjum vef eða einn fyrir alla.

Hvað gerist í reitunum

Gatan er kláruð á réttu formi, staðurinn valinn meðal þeirra sem hafa þá götu, póstnúmerið sett af vélinni. Þar sem hverfið ræður póstnúmerinu, eins og í Reykjavík, kemur póstnúmer hverfisins með húsnúmerinu.