KYC géographique
Vérifier qu'une adresse client tombe bien dans une préfecture autorisée par la conformité BCEAO.
Régions, préfectures, communes, cantons restitués dans leur dénomination locale officielle. Un endpoint, cinq niveaux, géocodage inverse, et une temporalité par ?as_of= pour les frontières qui évoluent.
OpenStreetMap, les portails gouvernementaux, les exports académiques — tout existe, dispersé, dans des formats incompatibles, sans toponymie officielle ni SLA. miGeoAPI normalise et expose la couche manquante.
Compatible avec la nomenclature OSM (admin_level). Les libellés locaux sont versionnés par pays — au Togo une commune n’est pas une commune au Sénégal. Pagination cursor-based, GeoJSON natif, historisation via boundary_changes.
Géocodage inverse, recherche par name, filtrage par niveau, requête spatiale ?lat&lng, accès historique par ?as_of=. Codes HTTP idiomatiques, réponses JSON et GeoJSON natifs.
curl -H "Authorization: Bearer sk_live_..." \
"https://api.migeoapi.com/v1/reverse?\
lat=6.1319&lng=1.2228&\
country_code=TG&include_parents=true"{
"point": { "lat": 6.1319, "lng": 1.2228 },
"boundary": {
"code_official": "TG-MA-LK-AGN",
"name_local": "Agouègan",
"level_name": "Canton",
"admin_level": 8
},
"parents": [
{ "level": 7, "name_local": "Aného" },
{ "level": 6, "name_local": "Lacs" },
{ "level": 4, "name_local": "Maritime" }
]
}Chaque endpoint répond à un cas d’usage concret, pas à une démo de capacités.
Vérifier qu'une adresse client tombe bien dans une préfecture autorisée par la conformité BCEAO.
Calculer le coût de routing par canton, exclure les zones d'accès difficile, agréger par région.
Composant React autocomplete qui suggère région → préfecture → canton avec dénomination locale.
Découper une opération de recensement ou d'aide humanitaire par maillage administratif officiel.
Priorité aux découpages où nous avons accès aux gazettes officielles et aux référentiels nationaux. Pas de devinettes, pas de scrapping OSM brut sans re-vérification humaine.
?lang= bascule la dénomination. Fallback automatique sur la langue officielle du pays.
?as_of=YYYY-MM-DD reconstruit le découpage tel qu'il était à cette date. Suit boundary_changes.
Stable sur les grandes collections. Pas d'offset drift entre deux requêtes pendant un import.
Accept: application/geo+json renvoie un FeatureCollection directement utilisable par MapLibre.
La v2 coexistera sans rupture de contrat. Tu ne réécris pas ton client quand on évolue.
quota.warning, quota.exceeded, boundary.updated. HMAC signé. Replay-safe.
SLA contractuels, quotas mensuels, rate limit par minute. Quatre paliers, du prototype au déploiement national. Changement de plan sans rupture de clé API.