API & data

Design an address form people can understand

Suggestions reduce typing when people can still choose and correct their address.

Show enough context

A suggestion should distinguish streets with the same name. Display the city and postal code alongside the street, without forcing the first result. In a Papaye form or your own product, users should be able to review the selected address before submitting.

Handle missing suggestions

A new street, a typo, or a service outage may interrupt a search. Offer another attempt and, when the workflow allows it, clearly labeled manual entry. Do not present a missing suggestion as proof that an address does not exist. Keep the error message close to the relevant field.

Test keyboard use too

Browse suggestions without a mouse, check that focus returns correctly, and confirm that the selection is retained. Also try a long address on a phone. A fast-loading list may still be hard to use if its content is cut off.

Checklist

  • Display the city
  • Explain service unavailability
  • Test keyboard and mobile

Primary sources