miGeoAPI
Créer un compte
Produit

Quatre métiers, un besoin précis.

Chaque endpoint répond à un cas d’usage concret — la douleur, l’usage, le résultat.

Trois façons d’utiliser la donnée officielle.

REST/JSON, GeoJSON natif, tuiles vectorielles. Authentification par clé Bearer, versionné sous /v1.

/v1/reverse

Géocodage inverse

D’un couple lat/lng à l’entité administrative exacte, jusqu’au canton. Idéal pour rattacher une adresse ou un capteur à sa commune officielle.

  • include_parents pour toute la hiérarchie
  • /v1/contains pour tester l’appartenance
/v1/tiles

Tuiles vectorielles (MVT)

Les frontières servies en Mapbox Vector Tiles, prêtes pour MapLibre GL ou Mapbox GL. Simplification adaptative par zoom côté PostGIS.

  • Un canton apparaît à z≥8, pas à z=4
  • TileJSON standard, cache HTTP edge
/v1/boundaries

Frontières & hiérarchie

Liste paginée par pays et niveau, GeoJSON natif (RFC 7946), pagination cursor stable, et une temporalité as_of pour interroger la donnée à une date pivot.

  • Filtres pays + niveau + parent
  • API versionnée /v1, sans breaking change

Une requête. La donnée officielle.

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.

Requête — qui contient ce point ?
curl -H "Authorization: Bearer sk_live_..." \
  "https://api.geoapi.mikollect.com/v1/reverse?\
lat=6.1319&lng=1.2228&\
country_code=TG&include_parents=true"
Réponse — niveau le plus fin + parents
{
  "point":    { "lat": 6.1319, "lng": 1.2228 },
  "boundary": {
    "code_official": "TG.MARITIME.GOLFE.GOLFE-4.AMOUTIVE",
    "name_local":    "AMOUTIVE",
    "level_name":    "Canton",
    "admin_level":   8
  },
  "parents": [
    { "level": 7, "name_local": "Golfe 4" },
    { "level": 6, "name_local": "Golfe" },
    { "level": 4, "name_local": "Maritime" }
  ]
}

Le Togo aujourd’hui. L’Ouest demain.

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.

Fintechs & banques

La douleur

Prouver, pour chaque client, que son adresse tombe dans une zone couverte par l’agrément — sans dépendre d’une carte papier ou d’un jugement humain contestable en cas de contrôle.

L’usage

À l’ouverture de compte, le back-end envoie la position à /v1/reverse ; la préfecture officielle retournée est comparée à la liste des zones autorisées (conformité BCEAO).

Le résultat

La vérification passe d’un contrôle manuel sur carte, source de litiges, à une règle automatisée et traçable — rejouable via ?as_of= si un régulateur la redemande.

/v1/reverse

Logisticiens

La douleur

Découper le territoire de livraison en zones de tarification cohérentes avec les limites administratives réelles, plutôt que des cercles ou des polygones dessinés à la main.

L’usage

Le moteur de tarification interroge /v1/contains pour chaque commande, agrège le coût par canton, puis remonte au niveau région pour le reporting mensuel.

Le résultat

Le découpage tarifaire suit une frontière officielle et stable ; il ne bouge plus à chaque mise à jour d’une carte tierce, et les litiges sur « où commence quelle zone » diminuent.

/v1/contains

Développeurs & agences

La douleur

Livrer un sélecteur d’adresse région → préfecture → canton fiable, sans maintenir soi-même un référentiel administratif à jour dans un CSV bricolé.

L’usage

L’autocomplete interroge /v1/boundaries filtré par niveau et parent pour peupler les listes en cascade, avec pagination cursor stable sur les grandes collections.

Le résultat

Le référentiel n’est plus un fichier maintenu à la main — c’est une source versionnée, avec les mêmes noms que la gazette officielle.

/v1/boundaries

Public & ONG

La douleur

Cadrer une opération de recensement ou d’aide humanitaire sur le maillage administratif que les autorités reconnaissent — pas un découpage improvisé pour le projet.

L’usage

L’équipe terrain exporte les polygones GeoJSON de /v1/boundaries par canton, et utilise /v1/tiles pour l’affichage cartographique.

Le résultat

Les rapports s’agrègent nativement au niveau préfecture ou région attendu par les autorités et les bailleurs, sans retraitement manuel des zones.

/v1/boundaries + /v1/tiles
Créer un compte gratuit