@abdurrahmanbd/bd-机构列表

我建立这个计划是因为我需要一种快速的方法, 来寻找孟加拉教育机构的EIIN号码, 于是我整理出一个 32,000 + 学校,学院,大学, 和Madrashas 的 干净,打字的数据集, 并把它包裹在一个简单的API中.

EIIN检索为O(1),因为数据在构建时被预索引为地图. 没有网络呼叫,没有数据库——一切运行在客户端的内存中.

Live Demo 和游戏场 ~

盒子里的东西

• O(1) EIIN 检索 ——通过EIIN号码,立即取回机构. 它在引擎盖下使用预建的地图,所以没有迭代.
• 双语搜索( L) ——按机构名称,简称查询BUET),区,分区,upazila,或EIIN. 不区分大小写,处理部分匹配.
• 32 000多个机构 ——学校(bangla & 英语媒体),学院,公立和私立大学,国立大学,aliya & qawmi madrashas.
• 无害环境管理+CJS - 与双方合作 import 财务报告和审定财务报表 require船舶 .d.ts 文档可以自动完成编辑器.
• 无依赖关系 - 刚刚安装和使用。 没有别的东西可以设置.

安装

npm install @abdurrahmanbd/bd-institution-list

或者如果你喜欢pnpm/yarn:

pnpm add @abdurrahmanbd/bd-institution-list
# or
yarn add @abdurrahmanbd/bd-institution-list

使用量

带有ES模块

import {
  searchInstitutes,
  getInstituteByEiin,
  getUniversities,
  getSchools,
  getColleges,
  getMadrashas,
} from "@abdurrahmanbd/bd-institution-list";

// search by name
const results = searchInstitutes("BUET");

// O(1) lookup by EIIN
const school = getInstituteByEiin(100003);
// => { eiin: 100003, name: "DAKSHIN KATHALIA TAZEM ALI SECONDARY SCHOOL", institutionType: "school", version: "bangla" }

// grab all public universities
const publicUnis = getUniversities({ category: "public" });

// english medium schools only
const englishSchools = getSchools({ version: "english" });

// all madrashas (aliya + qawmi)
const madrashas = getMadrashas();

带有共同JS

const {
  searchInstitutes,
  getInstituteByEiin,
  getUniversities,
} = require("@abdurrahmanbd/bd-institution-list");

const results = searchInstitutes("Dhaka College");

子路径导出( 优化导入大小)

对于更小的捆绑大小,只导入所需的特定数据集:

// Import only universities (~0.13 kB entry, shared data chunk)
import { getUniversities, publicUniData, privateUniData, nuUniData }
  from "@abdurrahmanbd/bd-institution-list/universities";

// Import only schools
import { getSchools, schoolData, englishMediumData }
  from "@abdurrahmanbd/bd-institution-list/schools";

// Import only colleges
import { getColleges, collegeData }
  from "@abdurrahmanbd/bd-institution-list/colleges";

// Import only madrashas (aliya + qawmi data, getMadrashas function)
import { getMadrashas, madrashaData, qawmiMadrashaData }
  from "@abdurrahmanbd/bd-institution-list/madrashas";

API 密码

searchInstitutes(query, options?)

按名称(英语/Bengali),地点(区,分区,upazila),简称,或EIIN. 结果排出:准确匹配先,然后启动With,然后包含.

searchInstitutes("ঢাকা", { type: "college", limit: 10 });
searchInstitutes("Sylhet", { type: "university" });
searchInstitutes(100003); // search by EIIN as a number

getInstituteByEiin(eiin)

用EIIN的号码查查一个机构 返回机构或 undefined。这是 O(1) —— 直取地图,而不是扫描.

const inst = getInstituteByEiin(100015);

getInstitutesByEiins(eiins)

由EIIN数字列表进行批量检索. 每一次检查都是O(1). 返回只找到机构(漏掉 EIINs 被悄悄跳过) .

const list = getInstitutesByEiins([100003, 100015, 100027]);

getAllInstitutes(options?)

得到所有的机构。 通过过滤选项缩小范围,并用 page 财务报告和审定财务报表 limit。 。 。 .

const firstPage = getAllInstitutes({ page: 1, limit: 50 });
const dhakaColeges = getAllInstitutes({ type: "college", district: "Dhaka" });

getSchools(options?)

获得所有学校(孟加拉语、英语)。 支持过滤 version。 。 。 .

const banglaSchools = getSchools({ version: "bangla" });
const englishSchools = getSchools({ version: "english" });

getColleges(options?)

把孟加拉国所有的大学都弄来.

const colleges = getColleges({ limit: 20 });

getUniversities(options?)

获得所有大学——公立,私立,国立. 过滤器由 category 或者说 department。 。 。 .

const medicalUnis = getUniversities({ category: "public", department: "medical" });
const privateUnis = getUniversities({ category: "private" });

getMadrashas(options?)

得到所有的疯狂——阿利亚和卡米。 支持所有标准过滤选项.

const allMadrashas = getMadrashas();
const dhakaM = getMadrashas({ district: "Dhaka", limit: 20 });

getInstitutesByDistrict(district, type?)

按区名过滤的简称. 可选限于特定类型的机构.

const sylhetSchools = getInstitutesByDistrict("Sylhet", "school");
const allInChittagong = getInstitutesByDistrict("Chittagong");

getInstitutesByDivision(division, type?)

按分区名称过滤的简称 .

const dhakaDiv = getInstitutesByDivision("Dhaka", "university");

getInstitutesByUpazila(upazila, type?)

用Upazila名进行过滤的简称.

const mirpurSchools = getInstitutesByUpazila("Mirpur", "school");

countInstitutes(options?)

计算匹配可选过滤选项的机构 。 需要总数而不获取所有记录时有用 .

countInstitutes();                          // 32544 — total
countInstitutes({ type: "university" });    // all universities
countInstitutes({ type: "school", district: "Dhaka" }); // schools in Dhaka

getAllDistricts(type?)

获取数据集中所有唯一区名的排序列表 。 可选限于一种类型的机构.

const districts = getAllDistricts();           // all districts
const uniDistricts = getAllDistricts("university"); // only where unis exist

getAllDivisions(type?)

获取数据集中所有唯一分区名称的排序列表 .

const divisions = getAllDivisions();

过滤选项

所有获取器函数接受可选过滤对象 :

{
  type?: "school" | "college" | "university" | "madrasha";
  version?: "bangla" | "english" | "arabic";        // schools & madrashas
  category?: "public" | "private" | "national";     // universities
  department?: "general" | "engineering" | "medical" | "agricultural" | "textile" | "dental";
  district?: string;   // case-insensitive substring match
  division?: string;   // case-insensitive substring match
  upazila?: string;    // case-insensitive substring match
  limit?: number;      // max records to return (default: all)
  page?: number;       // 1-indexed page number (works with limit)
}

关于地点数据的说明数字 : district, (中文(简体) ), division,以及 upazila 过滤完全适用于大学和疯人院。 学校和学院目前在数据集中的位置数据有限——这些类型的位置过滤器返回的结果可能较少.

数据覆盖

捐款

如果您发现任何缺失的机构或错误的数据,请随意打开一个问题或发送公关.

说明: 此寄存器目前设置为私有 。 如果你想捐款,请先联系我 这样我就可以允许你进入.. 阿卜杜勒·拉赫曼。 。 。 .

许可证

麻省理工学院 - 阿卜杜勒·拉赫曼