Drop in any lat/lng and country code. Get back a hyperlocal address string, a Plus Code, the full admin hierarchy, elevation, metro anchor, and a human-readable context string — plus a companion print-ready QR code for labels and receipts.
The standard address field stays untouched. Then customAddress layers in the pieces your product cares about — country, metro, market, nearby anchor — to create something that feels local, readable, and operationally useful.
CMOptional ISO2 prefix for country-aware addressing
KRIVariable-length metro segment, default 3 letters
BENMarket / hub segment chosen from local commercial gravity
MBEKA5-letter anchor code from the nearest useful local anchor
f935cdb5The original hyperlocal address remains intact as the final core token
GET /customAddress/CM/2.888527176989689/9.89871021523016?
includeCountry=true&includeMetro=true&metroLength=3&
includeMarket=true&marketLength=3&range=50No street name, no postcode, no city list. Any GPS coordinate — anywhere on Earth — resolves to a complete structured address.
Every response includes an Open Location Code (Plus Code) — a globally interoperable, shareable coordinate address derived directly from your coordinates.
The full within chain — from quarter to region — gives you every admin boundary the coordinate falls inside. No reverse-geocoding API needed.
Terrain elevation in metres (DEM field) returned with every address. Use it for delivery costing, navigation, or context-aware logistics.
The dominant metro — the city or town the coordinate is economically anchored to — giving you the human-readable 'city' context for any address.
A pre-built, human-readable full location description — ready to embed in receipts, delivery labels, reports, or AI prompts.
Alongside the address, generate a scannable SVG QR code — encoding the address string, nearest place, and metro anchor. Drop it straight into a label, waybill, or receipt template. No image processing required.
The /address endpoint bundles five resolution engines into a single authenticated call: hyperlocal channel maths, Open Location Code generation, LMDB admin lookup, metro gravity scoring, and context string assembly. You pay 2 credits and get back everything you need.
Provide lat, lng, and the 2-letter ISO country code. Optionally set a range in metres to control the precision tier of the address string.
The engine simultaneously computes the hyperlocal address string, generates a Plus Code, and queries the country database for admin, metro, and context data.
You receive a single JSON object with address string, Plus Code, nearest place, admin hierarchy, elevation, metro reference, and the full context string.
The address string inherits the hyperlocal cell system. A tighter range produces a more precise cell key — useful for indoor or stall-level addressing. The default 1,100 m range suits most city and town addressing use cases.
| Precision | range= (metres) | Typical use |
|---|---|---|
| Spot | 50 | Indoor floor, kiosk, market stall |
| Block | 200 | City block, street segment |
| Quarter | 500 | Neighbourhood, trading cluster |
| Town | 1100 | Town centre, district (default) |
| City | 5000 | Metro area, city-wide |
| Region | 25000 | Province, wide-area |
addressHyperlocal channel string — the coordinate's precision-cell key. Use this as a shareable address token.plus_codeOpen Location Code (Plus Code) — a globally interoperable 10-character address code compatible with Google Maps, HERE, and offline apps.withinNested admin hierarchy from immediate container (quarter, neighbourhood) up through district, department, and region.demTerrain elevation in metres from the nearest resolved place. Useful for logistics costing, flood risk, and altitude-aware services.metroThe dominant city or town the coordinate is economically anchored to, with distance and direction.contextPre-built human-readable location description in the country's default language — ready for labels, reports, and AI prompts.anchorsEconomic anchor types reachable from this coordinate — immediate (on-foot), local (by bike/moto), and reachable (by vehicle).{
"lat": 3.8667,
"lng": 11.5167,
"country_code": "CM",
"address": "6b099229",
"plus_code": "6FMHVG88+MM",
"tier": "local_zone",
"range_m": 1100,
"dem": 734,
"within": {
"name": "Centre Commercial",
"type": "quarter",
"within": {
"name": "Yaoundé I",
"type": "district",
"within": {
"name": "Mfoundi",
"type": "department",
"within": { "name": "Centre", "type": "region" }
}
}
},
"anchors": {
"immediate": ["mall", "marketplace", "pharmacy"],
"local": ["city"],
"reachable": ["town"]
},
"metro": {
"name": "Yaoundé",
"type": "city",
"context": "574m SW of Yaoundé"
},
"context": "Dans l'orbite commerciale principale de Yaoundé...",
"country": { "name": "Cameroon", "code": "CM", "flag": "🇨🇲" }
}Attach a verifiable, shareable address to any delivery — even in areas with no street names. Use the context string on waybills and receipts.
Capture a customer's location as a structured address at onboarding. The admin hierarchy and metro fields fulfil address-of-record requirements without a postal system.
Surveyors, health workers, and agricultural teams tap once — get a structured address with elevation and admin context that writes directly to a form or database.
Replace free-text address fields with a GPS-resolved address string for customers in markets with no formal postal codes. Reduce failed deliveries.
Feed the context string directly into an LLM prompt as a structured location fact. No hallucinated place names — grounded, current, verifiable.
Use elevation, metro distance, and admin tier to price location-based risk — flood exposure, access time, urban vs. rural classification — all from a single API call.
Enter a coordinate and country code. The call goes to api.bwendi.com/address in real time. You need a free API key — grab one from your dashboard.
2 credits. One call. Full address.