Les adresses NADÈ dans votre application.

Le code d'une porte

Trois nombres : la commune, la rue, la porte. 01-104-61 se dit « zéro un, cent quatre, soixante et un ». La porte, c'est la distance en mètres depuis le début de la rue : impairs à gauche, pairs à droite, une lettre pour deux portes au même endroit (61A).

^(\d{2})-(\d{3,5})-(\d{1,5}[A-Z]?)$

Formes acceptées à la saisie, toutes ramenées à la forme ci-dessus : 01 104 61, 01.104.61, 1-104-61, Kaloum 104 61 (avec ou sans accents), l'ancienne écriture KA-104-61. Sans séparateur (0110461), plusieurs lectures sont possibles : le service les propose.

Les numéros des communes

Conakry : 01 à 13. Ailleurs, le premier chiffre dit la région (ordre des statistiques nationales : 4 Kankan, 8 Nzérékoré) et le second la commune urbaine, 0 pour le chef-lieu.

Le plus simple : « Choisir une adresse »

Une page légère, faite pour le téléphone, que vous ouvrez dans une iframe, une webview ou une fenêtre. La personne cherche son code ou se localise, puis choisit. Vous recevez un message avec l'adresse.

<script src="https://mail.nadeguinee.com/assets/nade.js"></script>
<script>
  document.querySelector("#adresse-livraison").onclick = async () => {
    const a = await NADE.choisir();          // null si la personne annule
    if (a) console.log(a.code, a.adresse, a.lat, a.lon, a.pluscode);
  };
</script>

Sans la bibliothèque : ouvrez https://mail.nadeguinee.com/choisir?origine=https://votre-site et écoutez message. Les messages : nade:pret, nade:adresse, nade:annuler. Dans une application mobile, le choix arrive aussi par ReactNativeWebView.postMessage, webkit.messageHandlers.nade (iOS) ou NadeAndroid.choisir (Android). Là où aucune plaque n'est encore posée, la personne peut envoyer le Plus Code de sa position : code vaut alors null.

{
  "type": "nade:adresse",
  "code": "01-104-61",
  "adresse": "61 rue Badenya, 01 Kaloum",
  "code_postal": "01", "adresse_lignes": ["61 rue Badenya", "01 Kaloum", "Conakry"],
  "numero": "61", "rue": "Rue Badenya", "quartier": "Almamya II", "commune": "Kaloum", "ville": "Conakry",
  "lat": 9.510251, "lon": -13.714418, "pluscode": "6CX8G76P+464",
  "validee": true, "exemple": false
}

La bibliothèque nade.js

Un seul fichier, sans dépendance, à servir depuis votre propre site si vous préférez.

NADE.normaliser("kaloum 104 61")   // "01-104-61"
NADE.lire("40-021-35")             // { commune: "40", nomCommune: "Kankan", rue: "021", porte: "35" }
NADE.aDire("01-104-61")            // "zéro un, cent quatre, soixante et un"
await NADE.chercher("01-104-61")   // l'adresse complète
await NADE.proches(9.5102, -13.7144) // les 5 portes les plus proches (300 m)

Services publics, sans clé

Pour la saisie et la localisation. Limités à 120 demandes par 10 minutes et par adresse IP. Aucune donnée personnelle : ni photo, ni note, ni nom d'habitant.

GET https://mail.nadeguinee.com/public/adresse?code=01-104-61
GET https://mail.nadeguinee.com/public/proches?lat=9.5102&lon=-13.7144
GET https://mail.nadeguinee.com/export/adresses.geojson      (toutes les adresses validées, mises à jour chaque heure)

L'API partenaires, avec clé

Pour les volumes importants et les signalements. La clé se demande sur la page Partenaires ; elle s'envoie dans l'en-tête X-Cle-API.

GET  https://mail.nadeguinee.com/api/v1/adresse?code=01-104-61
GET  https://mail.nadeguinee.com/api/v1/proches?lat=9.5102&lon=-13.7144&rayon=100     (500 m au plus, 50 réponses)
POST https://mail.nadeguinee.com/api/v1/signalement   {"code": "01-104-61", "message": "Plaque tombée"}

Ce qu'il faut savoir