Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ihfaz297/MND/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The nodes endpoint returns all 19 locations in the university bus network. Each node represents a stop, intersection, or destination that can be used as an origin or destination for route planning.

​
Get All Nodes

GET /api/nodes

​
Response Fields

​
count
number
Total number of nodes in the network
​
nodes
Node[]
Array of node objects. See Node model for full structure.

​
Complete Node List

All 19 locations in the network:

​
Bus Stops (15)

IDNameGoogle Maps Address
TILAGORTilagorTilagor, Sylhet, Bangladesh
SHIBGONJShibgonjShibgonj, Sylhet, Bangladesh
NAIORPULNaiorpulNaiorpul, Sylhet, Bangladesh
KUMARPARAKumarparaKumarpara, Sylhet, Bangladesh
PATHANTULAPathantulaPathantula, Sylhet, Bangladesh
MODINA_MARKETModina MarketModina Market, Sylhet, Bangladesh
CAMPUSCampusShahjalal University of Science and Technology, Sylhet, Bangladesh
CHOWHATTAChowhattaChowhatta, Sylhet, Bangladesh
JAIL_RDJail RdJail Road, Sylhet, Bangladesh
NAYASARAKNayasarakNayasarak, Sylhet, Bangladesh
RIKABI_BAZARRikabi-Bazar PointRikabi Bazar, Sylhet, Bangladesh
LAKKATURALakkaturaLakkatura, Sylhet, Bangladesh
SHEIKHGHATSheikhghatSheikhghat, Sylhet, Bangladesh
LAMABAZARLamabazarLamabazar, Sylhet, Bangladesh

​
Intersections (2)

IDNameGoogle Maps Address
SHAHI_EIDGAHShahi EidgahShahi Eidgah, Sylhet, Bangladesh
AMBARKHANAAmbarkhanaAmbarkhana, Sylhet, Bangladesh
SUBIDBAZARSubidbazarSubidbazar, Sylhet, Bangladesh

​
Destinations (2)

IDNameGoogle Maps Address
MEDICALMedicalSylhet MAG Osmani Medical College Hospital, Sylhet, Bangladesh
ZINDABAZARZindabazarZindabazar, Sylhet, Bangladesh

​
Node Types

​
Stop

Regular bus stops where buses pick up and drop off passengers. 
{
  "id": "TILAGOR",
  "name": "Tilagor",
  "type": "stop",
  "gmaps_address": "Tilagor, Sylhet, Bangladesh"
}

​
Intersection

Major intersections that serve as transfer points between routes. 
{
  "id": "AMBARKHANA",
  "name": "Ambarkhana",
  "type": "intersection",
  "gmaps_address": "Ambarkhana, Sylhet, Bangladesh"
}

​
Destination

Key destinations like hospitals, markets, or residential areas. 
{
  "id": "MEDICAL",
  "name": "Medical",
  "type": "destination",
  "gmaps_address": "Sylhet MAG Osmani Medical College Hospital, Sylhet, Bangladesh"
}

​
Node Connectivity

Each node is connected to others via:
  • Bus routes: Direct bus service
  • Local transport: CNG, rickshaw connections
  • Walking paths: Pedestrian connections
Use the route planning endpoint to find all possible connections: 
GET /api/routes?from=TILAGOR&to=MEDICAL&time=08:30

​
Getting Node Details

The basic /api/nodes endpoint returns minimal information. To get full node details including Google Maps addresses, you need to check the source data: 
{
  "id": "CAMPUS",
  "name": "Campus",
  "type": "stop",
  "gmaps_address": "Shahjalal University of Science and Technology, Sylhet, Bangladesh",
  "lat": 24.9204,
  "lng": 91.8354
}
Latitude and longitude coordinates are optional and may not be present for all nodes.

​
Usage in Route Planning

Node IDs are case-sensitive and must be provided exactly as returned: 
curl "http://localhost:3000/api/routes?from=TILAGOR&to=CAMPUS&time=08:30"

​
Finding Nodes Served by a Route

To see which nodes are served by a specific bus route: 
GET /api/routes/bus1
Response includes all stops: 
{
  "route_id": "bus1",
  "name": "Bus 1",
  "stops": [
    {
      "id": "TILAGOR",
      "name": "Tilagor",
      "type": "stop"
    },
    {
      "id": "SHIBGONJ",
      "name": "Shibgonj",
      "type": "stop"
    },
    {
      "id": "CAMPUS",
      "name": "Campus",
      "type": "stop"
    }
    // ... more stops
  ]
}
Most frequently used node pairs:
  1. TILAGOR → CAMPUS: Morning commute for students from residential areas
  2. CAMPUS → SUBIDBAZAR: Evening return to city center
  3. NAIORPUL → CAMPUS: Alternative residential area route
  4. CAMPUS → MEDICAL: Access to medical facilities
  5. CHOWHATTA → CAMPUS: Commercial area to university

Route Planning

Find routes between nodes

Bus Routes

See which buses serve each node

Node Model

Complete node data structure

Health Check

Get total node count

Build docs developers (and LLMs) love

Get started for freeTalk to us