The Aura Pharmacy Map is Oasis Liquido’s built-in geographic locator for pharmacies across Nicaragua. Powered by MapLibre GL and OpenFreeMap tile data, it renders an interactive map centred on the patient’s current position and overlays nearby pharmacy locations with live inventory counts. Instead of calling ahead or walking to a pharmacy that is out of stock, patients can see which outlets carry their medicines before they leave home.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/FlasheyEstudi/Oasis-Liquido/llms.txt
Use this file to discover all available pages before exploring further.
How the map works
Aura Map requests the patient’s device location (latitude and longitude) and passes those coordinates to the pharmacy search endpoint. The API returns a ranked list of pharmacies sorted bydistance_in_meters, each carrying its current inventory snapshot. The frontend renders each result as a pin on the MapLibre GL canvas using OpenFreeMap’s Nicaragua geography tiles.
Grant location access
The browser or mobile app prompts for permission to read the device’s GPS position. The map centres on your coordinates immediately.
Nearby pharmacies load
The app calls
GET /api/v1/pharmacies with your latitude and longitude. The backend computes the distance to every active pharmacy and returns results closest-first.Check live inventory
Tap any pharmacy pin to open its detail panel. The
available_medicines array shows each stocked medicine with its current stock count and price.Pharmacy interface
ThePharmacy object returned by the API includes both location data and the live inventory snapshot.
Medicine availability
Each entry inavailable_medicines describes one medicine stocked at that pharmacy.
available_medicines is populated only when the client passes a medicine_id query parameter or requests a single pharmacy’s detail view. A list query without a medicine filter omits the field to keep responses compact.Supported pharmacy chains
The platform seed data includes locations from the three major pharmacy chains operating across Nicaragua:| Chain | Coverage |
|---|---|
| Saba | Managua metro and major northern cities |
| Kielsa | National coverage including RAAN and RAAS regions |
| Medco | Managua and Occidente region |
Proximity search query parameters
Send aGET request to /api/v1/pharmacies. Pass coordinates to activate distance sorting and filtering.
| Query parameter | Type | Description |
|---|---|---|
latitude | number | Your current latitude (WGS 84) |
longitude | number | Your current longitude (WGS 84) |
radius_meters | number | Search radius from your position (optional) |
medicine_id | string | Return only pharmacies that stock this medicine |
page | number | Page number (default: 1) |
limit | number | Results per page (default: 20) |
Map technology
| Component | Technology |
|---|---|
| Rendering engine | MapLibre GL JS |
| Map tiles | OpenFreeMap (free, open-source Nicaragua tiles) |
| Coordinate system | WGS 84 (EPSG:4326) decimal degrees |
| Distance calculation | Haversine formula on the backend |
Pharmacies API
Full endpoint reference for pharmacy search, inventory, and management
Oasis Express delivery
Order medicines for home delivery directly from any pharmacy on the map