@geoalgeria/agriculture 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.ar.md +93 -0
- package/README.fr.md +93 -0
- package/README.md +111 -0
- package/data/agriculture.json +5098 -0
- package/data/csv/agriculture.csv +197 -0
- package/data/geojson/agriculture.geojson +1 -0
- package/data/metadata.json +29 -0
- package/index.js +22 -0
- package/package.json +57 -0
- package/types/index.d.ts +116 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025-2026 Yasser's Studio (https://yasser.studio)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.ar.md
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
[English](README.md) | [Français](README.fr.md) | **العربية**
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
# @geoalgeria/agriculture
|
|
6
|
+
|
|
7
|
+
**مؤسسات القطاع الفلاحي في الجزائر — كبيانات قابلة للتثبيت.**
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
10
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
# نظرة عامة
|
|
16
|
+
|
|
17
|
+
196 مؤسسة من القطاع الفلاحي مستخرجة من دليل **وزارة الفلاحة والتنمية الريفية والصيد البحري** — مديريات المصالح الفلاحية، محافظات الغابات، المعاهد التقنية ومراكز البحث، مراكز التكوين، الغرف الفلاحية، الدواوين والمجمعات العمومية — ثنائية اللغة (فرنسي/عربي)، مصنّفة، مع ربط بالولاية/البلدية وإحداثيات.
|
|
18
|
+
|
|
19
|
+
## التثبيت
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install @geoalgeria/agriculture
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## بداية سريعة
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
import { agriculture, institutionsByWilaya, institutionsByType } from "@geoalgeria/agriculture";
|
|
29
|
+
|
|
30
|
+
agriculture().length; // 196
|
|
31
|
+
|
|
32
|
+
// كل مديريات المصالح الفلاحية (واحدة لكل ولاية)
|
|
33
|
+
institutionsByType("dsa").length; // 58
|
|
34
|
+
|
|
35
|
+
// كل شيء في الجزائر العاصمة (الرمز 16)
|
|
36
|
+
institutionsByWilaya(16).map((r) => r.name);
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## ماذا يمكنك أن تبني
|
|
40
|
+
|
|
41
|
+
- دليل/محدّد مواقع للمؤسسات الفلاحية حسب الولاية
|
|
42
|
+
- دفتر اتصالات للمعاهد والدواوين والمجمعات الوطنية (هاتف/فاكس)
|
|
43
|
+
- طبقة خرائطية للبصمة الإدارية للقطاع الفلاحي
|
|
44
|
+
|
|
45
|
+
## المحتوى
|
|
46
|
+
|
|
47
|
+
| مجموعة البيانات | العدد | الإحداثيات | ملاحظات |
|
|
48
|
+
| --- | --- | --- | --- |
|
|
49
|
+
| `agriculture` | 196 | الـ196 كلها | دليل الوزارة، مُحدَّد بمركز البلدية/الولاية |
|
|
50
|
+
|
|
51
|
+
**حسب الشبكة (`type`)**
|
|
52
|
+
|
|
53
|
+
| النوع | العدد | المعنى |
|
|
54
|
+
| --- | --- | --- |
|
|
55
|
+
| `dsa` | 58 | مديريات المصالح الفلاحية (واحدة لكل ولاية) |
|
|
56
|
+
| `conservation_forets` | 48 | محافظات الغابات |
|
|
57
|
+
| `chambre_agriculture` | 49 | الغرف الفلاحية (+ الغرفة الوطنية) |
|
|
58
|
+
| `institut_recherche` | 16 | المعاهد التقنية ومراكز البحث (INRAA، INRF، ITGC، ITDAS…) |
|
|
59
|
+
| `centre_formation` | 11 | معاهد ومراكز التكوين (ITMAS/CFATSF/CFVA) |
|
|
60
|
+
| `groupe_public` | 10 | المجمعات العمومية (GVAPRO، AGROLOG، GIPLAIT…) |
|
|
61
|
+
| `office_public` | 4 | الدواوين العمومية (OAIC، ONIL، ONILEV، ONTA) |
|
|
62
|
+
|
|
63
|
+
**حسب دقة الإحداثيات** (`geo_precision`)
|
|
64
|
+
|
|
65
|
+
| القيمة | العدد | المعنى |
|
|
66
|
+
| --- | --- | --- |
|
|
67
|
+
| `commune_centroid` | 89 | العنوان يطابق بلدية؛ مركز تلك البلدية |
|
|
68
|
+
| `wilaya_centroid` | 107 | لا بلدية في العنوان؛ مركز مقرّ الولاية |
|
|
69
|
+
|
|
70
|
+
> تغطّي مديريات المصالح الفلاحية كل **58 ولاية**. أما محافظات الغابات (48) والغرف الفلاحية (49) فتستعمل التقسيم القديم لـ**48 ولاية** (ما قبل 2019)، حيث تُدمج ولايات الجنوب في ولاياتها الأم.
|
|
71
|
+
|
|
72
|
+
## الصيغ
|
|
73
|
+
|
|
74
|
+
- `data/agriculture.json` — المصفوفة الكاملة (مع أنواع `types/index.d.ts`)
|
|
75
|
+
- `data/csv/agriculture.csv` — ملف CSV
|
|
76
|
+
- `data/geojson/agriculture.geojson` — `FeatureCollection` (كل السجلات)
|
|
77
|
+
- `data/metadata.json` — الأعداد والمصادر وتاريخ التوليد
|
|
78
|
+
|
|
79
|
+
## كيف بُنيت البيانات
|
|
80
|
+
|
|
81
|
+
استُخرجت من دليل الوزارة (`madr.gov.dz/contact/دليل-الهاتف/`، النسخة العربية المحدَّثة؛ و`fr.madr.gov.dz/contact/annuaire/` للعناوين الثنائية للفئات)، ثم طُبِّعت إلى رموز الولايات الرسمية، ثم حُدِّدت مواقعها اعتمادًا على مجموعة بلديات geoalgeria. انظر `research/agriculture/` في المستودع.
|
|
82
|
+
|
|
83
|
+
## حول الدقة
|
|
84
|
+
|
|
85
|
+
> الأسماء والولاية والعنوان والهاتف/الفاكس **رسمية** (دليل الوزارة). الدليل لا يحتوي على **أي إحداثيات**: يُوضَع كل سجل في مركز البلدية المذكورة في عنوانه، أو — عند تعذّر ذلك — في مركز مقرّ الولاية (انظر `geo_precision`). هذه مواقع تقريبية للـ*ولاية/البلدية* وليست نقاطًا مساحية للمباني.
|
|
86
|
+
|
|
87
|
+
## المصدر والترخيص
|
|
88
|
+
|
|
89
|
+
بيانات من **وزارة الفلاحة والتنمية الريفية والصيد البحري** — قائمة واقعية للقطاع العمومي، يُعاد توزيعها كمرجع. يستعمل الربط بالولاية/البلدية مجموعة بيانات geoalgeria الأساسية. كود الحزمة تحت رخصة MIT (انظر [LICENSE](LICENSE)).
|
|
90
|
+
|
|
91
|
+
## أسئلة؟
|
|
92
|
+
|
|
93
|
+
افتح issue: https://github.com/yasserstudio/geoalgeria/issues
|
package/README.fr.md
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
[English](README.md) | **Français** | [العربية](README.ar.md)
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
# @geoalgeria/agriculture
|
|
6
|
+
|
|
7
|
+
**Les institutions du secteur agricole en Algérie — sous forme de données installables.**
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
10
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
# Aperçu
|
|
16
|
+
|
|
17
|
+
196 institutions du secteur agricole issues de l'annuaire du **Ministère de l'Agriculture et du Développement Rural (MADR)** — directions des services agricoles, conservations des forêts, instituts techniques et de recherche, centres de formation, chambres d'agriculture, offices et groupes publics — bilingue (FR/AR), typé, avec rattachement wilaya/commune et coordonnées.
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install @geoalgeria/agriculture
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Démarrage rapide
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
import { agriculture, institutionsByWilaya, institutionsByType } from "@geoalgeria/agriculture";
|
|
29
|
+
|
|
30
|
+
agriculture().length; // 196
|
|
31
|
+
|
|
32
|
+
// Toutes les directions des services agricoles (une par wilaya)
|
|
33
|
+
institutionsByType("dsa").length; // 58
|
|
34
|
+
|
|
35
|
+
// Tout dans Alger (code 16)
|
|
36
|
+
institutionsByWilaya(16).map((r) => r.name);
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Ce que vous pouvez construire
|
|
40
|
+
|
|
41
|
+
- Un annuaire/localisateur des institutions agricoles par wilaya
|
|
42
|
+
- Un carnet de contacts des instituts, offices et groupes nationaux (tél./fax)
|
|
43
|
+
- Une couche cartographique de l'empreinte administrative du secteur agricole
|
|
44
|
+
|
|
45
|
+
## Contenu
|
|
46
|
+
|
|
47
|
+
| Jeu de données | Nombre | Coordonnées | Notes |
|
|
48
|
+
| --- | --- | --- | --- |
|
|
49
|
+
| `agriculture` | 196 | les 196 | Annuaire MADR, géocodé au centroïde commune/wilaya |
|
|
50
|
+
|
|
51
|
+
**Par réseau (`type`)**
|
|
52
|
+
|
|
53
|
+
| Type | Nombre | Signification |
|
|
54
|
+
| --- | --- | --- |
|
|
55
|
+
| `dsa` | 58 | Directions des Services Agricoles (une par wilaya) |
|
|
56
|
+
| `conservation_forets` | 48 | Conservations des Forêts |
|
|
57
|
+
| `chambre_agriculture` | 49 | Chambres d'Agriculture (+ chambre nationale) |
|
|
58
|
+
| `institut_recherche` | 16 | Instituts techniques et de recherche (INRAA, INRF, ITGC, ITDAS…) |
|
|
59
|
+
| `centre_formation` | 11 | Instituts et centres de formation (ITMAS/CFATSF/CFVA) |
|
|
60
|
+
| `groupe_public` | 10 | Groupes publics (GVAPRO, AGROLOG, GIPLAIT…) |
|
|
61
|
+
| `office_public` | 4 | Offices publics (OAIC, ONIL, ONILEV, ONTA) |
|
|
62
|
+
|
|
63
|
+
**Par précision des coordonnées** (`geo_precision`)
|
|
64
|
+
|
|
65
|
+
| Valeur | Nombre | Signification |
|
|
66
|
+
| --- | --- | --- |
|
|
67
|
+
| `commune_centroid` | 89 | L'adresse correspond à une commune ; centroïde de cette commune |
|
|
68
|
+
| `wilaya_centroid` | 107 | Pas de commune dans l'adresse ; centroïde du chef-lieu de wilaya |
|
|
69
|
+
|
|
70
|
+
> Les DSA couvrent les **58 wilayas**. Les Conservations des Forêts (48) et les Chambres d'Agriculture (49) utilisent le découpage **48 wilayas** d'avant 2019 — les wilayas du Sud y sont rattachées à leurs wilayas mères.
|
|
71
|
+
|
|
72
|
+
## Formats
|
|
73
|
+
|
|
74
|
+
- `data/agriculture.json` — tableau complet (typé par `types/index.d.ts`)
|
|
75
|
+
- `data/csv/agriculture.csv` — CSV plat
|
|
76
|
+
- `data/geojson/agriculture.geojson` — `FeatureCollection` (tous les enregistrements)
|
|
77
|
+
- `data/metadata.json` — comptes, sources, date de génération
|
|
78
|
+
|
|
79
|
+
## Comment les données sont construites
|
|
80
|
+
|
|
81
|
+
Extraites de l'annuaire du MADR (`madr.gov.dz/contact/دليل-الهاتف/`, arabe — la version à jour ; `fr.madr.gov.dz/contact/annuaire/` pour les libellés bilingues des catégories), normalisées vers les codes wilaya officiels, puis géocodées sur l'ensemble des communes de geoalgeria. Voir `research/agriculture/` dans le monorepo.
|
|
82
|
+
|
|
83
|
+
## Sur la précision
|
|
84
|
+
|
|
85
|
+
> Les noms, la wilaya, l'adresse et le tél./fax sont **officiels** (annuaire du MADR). L'annuaire ne contient **aucune coordonnée** : chaque enregistrement est placé au centroïde de la commune nommée dans son adresse, ou — à défaut — au centroïde du chef-lieu de wilaya (voir `geo_precision`). Ce sont des emplacements approximatifs de la *wilaya/commune*, pas des points de bâtiments relevés.
|
|
86
|
+
|
|
87
|
+
## Source & licence
|
|
88
|
+
|
|
89
|
+
Données du **Ministère de l'Agriculture et du Développement Rural (MADR)** — un listing factuel du secteur public, redistribué à titre de référence. Le rattachement wilaya/commune utilise le jeu de données de base geoalgeria. Code du paquet sous MIT (voir [LICENSE](LICENSE)).
|
|
90
|
+
|
|
91
|
+
## Questions ?
|
|
92
|
+
|
|
93
|
+
Ouvrez une issue : https://github.com/yasserstudio/geoalgeria/issues
|
package/README.md
ADDED
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
**English** | [Français](README.fr.md) | [العربية](README.ar.md)
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
# @geoalgeria/agriculture
|
|
6
|
+
|
|
7
|
+
**Algeria's agriculture-sector institutions — as data you can install.**
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
10
|
+
[](https://www.npmjs.com/package/@geoalgeria/agriculture)
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
# Overview
|
|
16
|
+
|
|
17
|
+
196 agriculture-sector institutions from the **Ministry of Agriculture, Rural Development and Fisheries (MADR)** institutional directory — agricultural-services directorates, forest conservations, technical & research institutes, training centres, chambers of agriculture, public offices and groups — bilingual (FR/AR), typed, with wilaya/commune linkage and coordinates.
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install @geoalgeria/agriculture
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Quick start
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
import {
|
|
29
|
+
agriculture,
|
|
30
|
+
institutionById,
|
|
31
|
+
institutionsByWilaya,
|
|
32
|
+
institutionsByType,
|
|
33
|
+
metadata,
|
|
34
|
+
} from "@geoalgeria/agriculture";
|
|
35
|
+
|
|
36
|
+
agriculture().length; // 196
|
|
37
|
+
|
|
38
|
+
// All agricultural-services directorates (one per wilaya)
|
|
39
|
+
institutionsByType("dsa").length; // 58
|
|
40
|
+
|
|
41
|
+
// Everything in Alger (code 16)
|
|
42
|
+
institutionsByWilaya(16).map((r) => r.name);
|
|
43
|
+
|
|
44
|
+
// A single record, and dataset metadata
|
|
45
|
+
institutionById("16-office_public-01")?.abbreviation; // "OAIC"
|
|
46
|
+
metadata().wilayas_covered; // 58
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## What you can build
|
|
50
|
+
|
|
51
|
+
- A directory/locator for agricultural institutions by wilaya
|
|
52
|
+
- A contact book of the national institutes, offices and groups (phone/fax)
|
|
53
|
+
- A map layer of the agriculture sector's administrative footprint
|
|
54
|
+
|
|
55
|
+
## What's inside
|
|
56
|
+
|
|
57
|
+
| Dataset | Count | Coordinates | Notes |
|
|
58
|
+
| --- | --- | --- | --- |
|
|
59
|
+
| `agriculture` | 196 | all 196 | MADR directory, geocoded to commune/wilaya centroid |
|
|
60
|
+
|
|
61
|
+
**By network (`type`)**
|
|
62
|
+
|
|
63
|
+
| Type | Count | Meaning |
|
|
64
|
+
| --- | --- | --- |
|
|
65
|
+
| `dsa` | 58 | Directions des Services Agricoles (one per wilaya) |
|
|
66
|
+
| `conservation_forets` | 48 | Conservations des Forêts |
|
|
67
|
+
| `chambre_agriculture` | 49 | Chambres d'Agriculture (+ national chamber) |
|
|
68
|
+
| `institut_recherche` | 16 | Technical & research institutes (INRAA, INRF, ITGC, ITDAS…) |
|
|
69
|
+
| `centre_formation` | 11 | Training institutes & centres (ITMAS/CFATSF/CFVA) |
|
|
70
|
+
| `groupe_public` | 10 | Public groups (GVAPRO, AGROLOG, GIPLAIT…) |
|
|
71
|
+
| `office_public` | 4 | Public offices (OAIC, ONIL, ONILEV, ONTA) |
|
|
72
|
+
|
|
73
|
+
**By coordinate precision** (`geo_precision`)
|
|
74
|
+
|
|
75
|
+
| Value | Count | Meaning |
|
|
76
|
+
| --- | --- | --- |
|
|
77
|
+
| `commune_centroid` | 89 | Address matched a commune; centroid of that commune |
|
|
78
|
+
| `wilaya_centroid` | 107 | No commune in the address; centroid of the wilaya chief town |
|
|
79
|
+
|
|
80
|
+
> DSA covers all **58 wilayas**. Conservations des Forêts (48) and Chambres d'Agriculture (49) use the pre-2019 **48-wilaya** division — the southern wilayas fold into their parents there.
|
|
81
|
+
|
|
82
|
+
## Formats
|
|
83
|
+
|
|
84
|
+
- `data/agriculture.json` — full array (typed by `types/index.d.ts`)
|
|
85
|
+
- `data/csv/agriculture.csv` — flat CSV
|
|
86
|
+
- `data/geojson/agriculture.geojson` — `FeatureCollection` (all records)
|
|
87
|
+
- `data/metadata.json` — counts, sources, generated date
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
import data from "@geoalgeria/agriculture/data/agriculture.json" with { type: "json" };
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
```ts
|
|
94
|
+
import type { AgricultureInstitution } from "@geoalgeria/agriculture";
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## How the data is built
|
|
98
|
+
|
|
99
|
+
Extracted from the MADR directory (`madr.gov.dz/contact/دليل-الهاتف/`, Arabic — the up-to-date side; `fr.madr.gov.dz/contact/annuaire/` for the bilingual category labels), normalized to official wilaya codes, then geocoded against the geoalgeria commune set. See `research/agriculture/` in the monorepo for the full pipeline (`parse.py` → `normalize.py` → `geocode.py`).
|
|
100
|
+
|
|
101
|
+
## On accuracy
|
|
102
|
+
|
|
103
|
+
> Names, wilaya, address and phone/fax are **official** (from the MADR directory). The directory carries **no coordinates**: each record is placed at the centroid of the commune named in its address, or — when the address has no recognizable commune — at the centroid of the wilaya chief town (see `geo_precision`). These are approximate locations for the *wilaya/commune*, not surveyed building points. Some source rows have minor typos that have been normalized.
|
|
104
|
+
|
|
105
|
+
## Source & license
|
|
106
|
+
|
|
107
|
+
Data from the **Ministry of Agriculture, Rural Development and Fisheries (MADR)** — a factual public-sector listing, redistributed for reference. Wilaya/commune linkage uses the geoalgeria base dataset. Package code under MIT (see [LICENSE](LICENSE)).
|
|
108
|
+
|
|
109
|
+
## Questions?
|
|
110
|
+
|
|
111
|
+
Open an issue: https://github.com/yasserstudio/geoalgeria/issues
|