Country information - Switzerland

Sources: The Swiss dataset is compiled from official sources.
Update frequency: Monthly.
Postcodes: four digits, such as 4001 for Basel. One postcode can span several municipalities.

Finding an address

A postcode and house number don't identify a Swiss address. Autocomplete needs the postcode, settlement and street, or an addressId.
One house number can have several entrances, each its own address. The API then returns a 400 that lists their addressId values; pick one by its location or buildingName and repeat the request with that addressId. Rue Saint-Laurent 35 in Lausanne has two entrances, 19 metres apart.
Some addresses have no house number at all, such as the Hirslanden Klinik on Schänisweg in Aarau. Only their addressId selects them.

streetNumber is text, returned as the source writes it: 30, 4.1 (entrance 1 of number 4) or 2bis.1.
A letter or word directly after a number is the premise: a in 30a, bis in 2bis. Chemin de Mornex 5 in Lausanne exists only as 5a and 5b, so a request without a premise returns a 400 that lists them.
Every address from the source carries its addressId and, where the source names the building, a buildingName. An address you added yourself through feedback has neither.

canton: the Kanton, such as Basel-Stadt.
district: the Bezirk. It is absent in cantons without districts, such as Basel-Stadt.
region: the Grossregion, in English, such as Espace Mittelland or Eastern Switzerland.
settlement: the postal locality (Ortschaft), which need not match the municipality name.
Names are in the local language: Marktplatz in Basel, Rue du Port-Franc in Lausanne. Swiss Standard German uses ss, never ß; matching treats them as equal.