Suisse

• Sources : Le jeu de données suisse est compilé à partir de sources officielles.
• Fréquence de mise à jour : Mensuelle.
• Codes postaux : quatre chiffres, comme 4001 pour Bâle. Un code postal peut s'étendre sur plusieurs communes.

Trouver une adresse

• Un code postal et un numéro ne suffisent pas à identifier une adresse suisse. L'appel autocomplete exige le code postal, la localité et la rue, ou un addressId.
• Un même numéro peut avoir plusieurs entrées, chacune constituant une adresse distincte. L'API renvoie alors une erreur 400 qui liste leurs valeurs addressId ; choisissez-en une d'après son emplacement ou son buildingName, puis renvoyez la requête avec cet addressId. Rue Saint-Laurent 35 à Lausanne a deux entrées, distantes de 19 mètres.
• Certaines adresses n'ont aucun numéro, comme la Hirslanden Klinik sur le Schänisweg à Aarau. Seul leur addressId permet de les sélectionner.

Numéros de rue

• streetNumber est du texte, renvoyé tel que la source l'écrit : 30, 4.1 (entrée 1 du numéro 4) ou 2bis.1.
• Une lettre ou un mot accolé directement à un numéro est le premise : a dans 30a, bis dans 2bis. Chemin de Mornex 5 à Lausanne n'existe que sous les formes 5a et 5b ; une requête sans complément renvoie donc une erreur 400 qui les liste.
• Chaque adresse issue de la source porte son addressId et, lorsque la source nomme le bâtiment, un buildingName. Une adresse que vous avez ajoutée vous-même par un retour d'information n'a ni l'un ni l'autre.

Champs d'adresse

• canton : le Kanton, comme Basel-Stadt.
• district : le Bezirk. Il est absent dans les cantons sans districts, comme Bâle-Ville.
• region : la Grossregion, en anglais, comme Espace Mittelland ou Eastern Switzerland.
• settlement : la localité postale (Ortschaft), qui ne correspond pas forcément au nom de la commune.
• Les noms sont dans la langue locale : Marktplatz à Bâle, Rue du Port-Franc à Lausanne. L'allemand standard suisse s'écrit avec ss, jamais ß ; la recherche les traite comme équivalents.