حزمة npm

التقسيم الإداري كله في حزمة بأنواع TypeScript. تعمل بدون اتصال وبدون dependencies.

التثبيت

shell

npm install morocco-communes

الحزمة على npm

الاستعمال

JavaScript

import { regions, provincesOf, communesOf, getCommune } from "morocco-communes";

regions[0].name.fr;         // "Tanger-Tétouan-Al Hoceima"
provincesOf("01");          // عمالاتها وأقاليمها الـ8
communesOf("01.511");       // جماعات طنجة-أصيلة الـ12
getCommune("tanger");       // { code: "01.511.01.0", type: "urban", population: 1275428, ... }

كل قائمة هي أيضا module مستقل، فالقائمة المنسدلة للجهات لا تجلب معها كل الجماعات.

JavaScript

import regions from "morocco-communes/regions";

السجلات

القائمة	الحقول
regions	code, name, population
provinces	code, name, type, region, population
cercles	code, name, region, province, population
communes	code, slug, name, type, region, province, cercle, population, population2014
arrondissements	code, name, commune, population

name قيمته { fr, ar } وpopulation هو مجموع السكان في إحصاء 2024. الوحدة الأعلى معطاة برمزها، وcercle قيمته null في الجماعة الحضرية.

الدوال المساعدة

getCommune(codeOrSlug) تجد جماعة بـ01.511.01.0 أو tanger.
provincesOf(region) وcerclesOf(province) وarrondissementsOf(commune) تعطي الوحدات التابعة لوحدة.
communesOf(code) تقبل جهة أو إقليما أو دائرة.
version هو إصدار مجموعة البيانات، وهو إصدار الحزمة أيضا.

ما لا تتضمنه الحزمة

الحدود، وكل ما يستخرج منها (النقطة المركزية centroid، والمستطيل المحيط bounding box، ومعرف OpenStreetMap، والمساحة، والكثافة)، تحت رخصة ODbL، فتبقى في التنزيلات وفي API. عدد الأسر وتوزيع السكان بين مغاربة وأجانب خارج الحزمة كذلك.

الرخصة

الكود تحت رخصة MIT. البيانات مصدرها المندوبية السامية للتخطيط (الإحصاء العام للسكان والسكنى 2024 و2014)؛ اذكر المصدر عند نشرها.