@geoalgeria/buses 2.0.0 → 2.1.1

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 CHANGED
@@ -1,5 +1,10 @@
1
+ ## Code
2
+
1
3
  MIT License
2
4
 
5
+ This license applies to package code. Dataset contents carry separate licences;
6
+ see NOTICE.
7
+
3
8
  Copyright (c) 2025-2026 Yasser's Studio (https://yasser.studio)
4
9
 
5
10
  Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -19,3 +24,13 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
24
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
25
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
26
  SOFTWARE.
27
+
28
+ ## Data
29
+
30
+ CC-BY-SA-4.0 AND ODbL-1.0 AND LicenseRef-Operator-Data
31
+
32
+ ETUSA Line attributes come from French Wikipedia under CC BY-SA 4.0. Shapes, Directions, Stations, and memberships come from a reviewed OpenStreetMap snapshot under ODbL 1.0 with attribution © OpenStreetMap contributors.
33
+
34
+ ETUS Tiaret, ETUSTO, ETUS Béjaïa, ETUS M'Sila, ETUS Sidi Bel Abbès, ETUS Setif, ETUS Aïn Defla, ETUS Annaba, ETUS Tlemcen, ETO Oran, ETUS Oum El Bouaghi, and ETUL Laghouat Line facts come from official Operator pages, APIs, programs, and maps. The official source materials do not state an open reuse licence.
35
+
36
+ Data licences and attribution requirements are detailed in NOTICE.
package/NOTICE ADDED
@@ -0,0 +1,27 @@
1
+ @geoalgeria/buses data notices
2
+
3
+ Package code is licensed under the MIT License in LICENSE.
4
+
5
+ ETUSA Line attributes derived from French Wikipedia are licensed CC BY-SA 4.0:
6
+ https://creativecommons.org/licenses/by-sa/4.0/
7
+ Source: https://fr.wikipedia.org/wiki/Lignes_de_bus_ETUSA_de_1_à_99
8
+
9
+ OpenStreetMap-derived shapes, Directions, Stations, and memberships are made
10
+ available under the Open Database License (ODbL) 1.0. Attribution:
11
+ © OpenStreetMap contributors
12
+ https://www.openstreetmap.org/copyright
13
+
14
+ LicenseRef-Operator-Data
15
+
16
+ Factual Line identities, endpoints, stop counts, and service hours attributed
17
+ to ETUS Tiaret, ETUSTO, ETUS Béjaïa, ETUS M'Sila, ETUS Sidi Bel Abbès,
18
+ ETUS Setif, ETUS Aïn Defla, ETUS Annaba, ETUS Tlemcen, ETO Oran,
19
+ ETUS Oum El Bouaghi, and ETUL Laghouat are extracted from those Operators'
20
+ official websites, APIs, programs, and maps. Those source materials do not
21
+ state an open reuse licence. All rights in the source materials remain with
22
+ their respective Operators; their inclusion as factual reference data does not
23
+ grant additional rights beyond applicable law.
24
+
25
+ Database rights and share-alike obligations may apply to redistributed derived
26
+ databases. This notice does not replace any applicable licence text or source
27
+ terms.
package/README.ar.md CHANGED
@@ -4,22 +4,22 @@
4
4
 
5
5
  # @geoalgeria/buses
6
6
 
7
- **شبكات الحافلات الحضرية في الجزائر — كبيانات جاهزة للتثبيت.**
7
+ **شبكات الحافلات الحضرية في الجزائر، كبيانات جاهزة للتثبيت.**
8
8
 
9
9
  [![npm](https://img.shields.io/npm/v/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
11
+ [![Code: MIT](https://img.shields.io/badge/Code-MIT-green.svg)](LICENSE)
12
12
 
13
13
  </div>
14
14
 
15
15
  <div dir="rtl">
16
16
 
17
- **خطوط** الحافلات الحضرية في الجزائر — المحطتان الطرفيتان، عدد المواقف، والبلديات والمحطات
18
- التي يخدمها كل خط. مجموعة بيانات **متعددة المشغّلين**؛ تُصدر النسخة الأولى **50 خطًّا لإيتوزا
19
- (ETUSA)** بالجزائر العاصمة. بصيغتي JSON و CSV. جزء من
17
+ بيانات مراجعة لخطوط الحافلات الحضرية وشبه الحضرية: **153 خطًا** و**76 مسارًا** و**128 اتجاهًا**
18
+ و**1,603 محطة** لدى 14 مشغّلًا.
19
+ بصيغ JSON وCSV وGeoJSON. جزء من
20
20
  [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
21
21
 
22
- > **المشغّل (المصدر):** ETUSA — مؤسسة النقل الحضري وشبه الحضري لمدينة الجزائر. ستُضاف مدن/
22
+ > **المشغّل (المصدر):** ETUSA – مؤسسة النقل الحضري وشبه الحضري لمدينة الجزائر. ستُضاف مدن/
23
23
  > مشغّلون آخرون. للمحطات البرية بين الولايات انظر
24
24
  > [`@geoalgeria/gares-routieres`](https://www.npmjs.com/package/@geoalgeria/gares-routieres)؛
25
25
  > وللسكك/الترامواي/المترو انظر [`@geoalgeria/ferroviaire`](https://www.npmjs.com/package/@geoalgeria/ferroviaire).
@@ -32,8 +32,8 @@ npm install @geoalgeria/buses
32
32
 
33
33
  ```js
34
34
  import buses from "@geoalgeria/buses";
35
- const all = buses.lines(); // 50
36
- const etusa = buses.linesByOperator("ETUSA"); // 50
35
+ const all = buses.lines(); // 153
36
+ const etusa = buses.linesByOperator("ETUSA"); // 76
37
37
  ```
38
38
 
39
39
  <div dir="rtl">
@@ -42,17 +42,22 @@ const etusa = buses.linesByOperator("ETUSA"); // 50
42
42
 
43
43
  | مجموعة البيانات | العدد | ملاحظات |
44
44
  | --- | --- | --- |
45
- | خطوط الحافلات الحضرية | **50** | ETUSA (الجزائر) — المحطتان الطرفيتان، عدد المواقف، البلديات والمحطات المخدومة |
45
+ | الخطوط | **153** | 14 مشغلًا؛ تبقى الخطوط الرسمية بدون مسار متاحة في الدليل |
46
+ | المسارات | **76** | مسارات OSM مراجعة |
47
+ | الاتجاهات | **128** | علاقات OSM المصدرية |
48
+ | المحطات | **1,603** | عقد OSM مع الحفاظ على الأسماء الفارغة |
46
49
 
47
- > **النطاق (v1):** خصائص على مستوى الخط فقط. أما **الهندسة الجغرافية** لكل موقف/خط
48
- > (OSM `route=bus`) فمؤجّلة إلى **v1.1** (تغطية OSM الموسومة بـETUSA ضعيفة حاليًا).
49
- > تغطي 50 من ~122 خطًّا لركّاب ETUSA. `wilaya_code` = `16` (الجزائر).
50
+ ترتيب العضويات البالغ عددها 2,685 هو ترتيب أعضاء علاقة OSM الخام ويحمل القيمة
51
+ `osm_member_order_unvalidated`؛ وليس ترتيب ركوب متحققًا ولا نستنتج منه المحطات الطرفية.
50
52
 
51
53
  ## المصدر والرخصة
52
54
 
53
- بيانات الخطوط من **fr.wikipedia** (مقالات خطوط ETUSA) — برخصة **CC BY-SA 4.0** (الإسناد +
54
- المشاركة بالمثل). المشغّل: **ETUSA**. شيفرة الحزمة تحت [MIT](LICENSE)؛ وتَرِث بيانات الخطوط
55
- رخصة CC BY-SA. تحقّق من ETUSA للخطوط الرسمية والمحدّثة.
55
+ خصائص خطوط ETUSA من **fr.wikipedia** برخصة **CC BY-SA 4.0**. المسارات والاتجاهات والمحطات
56
+ من OpenStreetMap برخصة **ODbL 1.0** مع الإسناد **© OpenStreetMap contributors**.
57
+ حقائق خطوط 12 مشغلًا المذكورة في [NOTICE](NOTICE) مستخرجة من مصادر المشغلين الرسمية التي لا
58
+ تعلن رخصة مفتوحة. تُستخدم خرائط Google الخاصة ببجاية ومخططات المسيلة وصور مسارات سيدي بلعباس للتحقق فقط ولا نعيد نشر هندستها.
59
+ تتضمن بيانات سيدي بلعباس قوائم الانطلاق الكاملة المنسوخة من HTML الرسمي المقدم، وتبقى أيام الخدمة غير المذكورة بقيمة `null`.
60
+ الشيفرة تحت [MIT](LICENSE)، والتفاصيل في [NOTICE](NOTICE).
56
61
 
57
62
  [تصفّح كل الحزم →](https://geoalgeria.com/data)
58
63
 
package/README.fr.md CHANGED
@@ -4,21 +4,20 @@
4
4
 
5
5
  # @geoalgeria/buses
6
6
 
7
- **Les réseaux de bus urbains d'Algérie — en données prêtes à installer.**
7
+ **Les réseaux de bus urbains d'Algérie, en données prêtes à installer.**
8
8
 
9
9
  [![npm](https://img.shields.io/npm/v/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
11
+ [![Code: MIT](https://img.shields.io/badge/Code-MIT-green.svg)](LICENSE)
12
12
 
13
13
  </div>
14
14
 
15
- Les **lignes** de bus urbains d'Algérie — terminus, nombre d'arrêts, communes et stations
16
- desservies par chaque ligne. Jeu de données **multi-exploitants** ; la v1 livre **50 lignes
17
- ETUSA** (Alger). En JSON et CSV. Fait partie de
15
+ Les **lignes** de bus urbains et suburbains d'Algérie. Cette version livre **153 lignes**,
16
+ **76 tracés**, **128 directions** et **1 603 stations** pour 14 exploitants. En JSON,
17
+ CSV et GeoJSON. Fait partie de
18
18
  [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
19
19
 
20
- > **Exploitant (source) :** ETUSA — Établissement de transport urbain et suburbain d'Alger.
21
- > D'autres villes/exploitants seront ajoutés. Pour les gares routières voir
20
+ > Pour les gares routières inter-wilayas voir
22
21
  > [`@geoalgeria/gares-routieres`](https://www.npmjs.com/package/@geoalgeria/gares-routieres) ;
23
22
  > pour rail/tram/métro voir [`@geoalgeria/ferroviaire`](https://www.npmjs.com/package/@geoalgeria/ferroviaire).
24
23
 
@@ -28,27 +27,35 @@ npm install @geoalgeria/buses
28
27
 
29
28
  ```js
30
29
  import buses from "@geoalgeria/buses";
31
- const all = buses.lines(); // 50
32
- const etusa = buses.linesByOperator("ETUSA"); // 50
33
- const l1 = buses.lineById("etusa-1");
30
+ const all = buses.lines(); // 153
31
+ const etusa = buses.linesByOperator("ETUSA"); // 76
32
+ const trace = buses.shapeForLine("etusa-1");
34
33
  ```
35
34
 
36
35
  ## Contenu
37
36
 
38
37
  | Jeu de données | Nombre | Notes |
39
38
  | --- | --- | --- |
40
- | Lignes de bus urbaines | **50** | ETUSA (Alger) — terminus, nombre d'arrêts, communes & stations desservies |
39
+ | Lignes | **153** | 14 exploitants ; lignes officielles sans tracé conservées dans l'annuaire |
40
+ | Tracés OSM | **76** | 61 ETUSA + 15 lignes des autres exploitants |
41
+ | Directions | **128** | Relations OSM sources |
42
+ | Stations | **1 603** | Nœuds OSM, noms nuls conservés |
41
43
 
42
- > **Portée (v1) :** attributs au niveau ligne uniquement. La **géométrie** par arrêt/ligne
43
- > (OSM `route=bus`) est reportée à la **v1.1** (couverture OSM taguée ETUSA insuffisante).
44
- > Couvre 50 des ~122 lignes voyageurs ETUSA. `wilaya_code` = `16` (Alger).
44
+ L'ordre des 2 685 appartenances est l'ordre brut des membres OSM, marqué
45
+ `osm_member_order_unvalidated` : il ne constitue pas un ordre voyageurs validé et aucun
46
+ terminus n'est déduit automatiquement.
45
47
 
46
48
  ## Source & licence
47
49
 
48
- Données de lignes issues de **fr.wikipedia** (articles des lignes ETUSA) — sous licence
49
- **CC BY-SA 4.0** (attribution + partage à l'identique). Exploitant : **ETUSA**. Le code du
50
- paquet est sous [MIT](LICENSE) ; les données de lignes héritent de la licence CC BY-SA de
51
- Wikipédia. Vérifiez auprès d'ETUSA pour les lignes officielles et à jour.
50
+ Les attributs ETUSA issus de **fr.wikipedia** sont sous **CC BY-SA 4.0**. Les tracés,
51
+ directions et stations OpenStreetMap sont sous **ODbL 1.0**, attribution
52
+ **© OpenStreetMap contributors**. Les faits de 12 exploitants cités dans
53
+ [NOTICE](NOTICE) sont extraits de sources officielles sans licence ouverte déclarée ; les cartes Google de
54
+ Béjaïa, les schémas de M'Sila et les images de tracé de Sidi Bel Abbès servent uniquement
55
+ à la validation et leur géométrie n'est pas redistribuée. Les départs complets de Sidi
56
+ Bel Abbès sont transcrits du HTML officiel fourni par le propriétaire du projet ; les
57
+ jours non indiqués restent explicitement inconnus.
58
+ Le code est sous [MIT](LICENSE) ; voir [NOTICE](NOTICE).
52
59
 
53
60
  [Voir tous les paquets →](https://geoalgeria.com/data)
54
61
 
package/README.md CHANGED
@@ -1,25 +1,9 @@
1
1
  **English** | [Français](README.fr.md) | [العربية](README.ar.md)
2
2
 
3
- <div align="center">
4
-
5
3
  # @geoalgeria/buses
6
4
 
7
- **Algeria's urban bus networks — as data you can install.**
8
-
9
- [![npm](https://img.shields.io/npm/v/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
10
- [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/buses)](https://www.npmjs.com/package/@geoalgeria/buses)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
12
-
13
- </div>
14
-
15
- Urban bus **lines** across Algeria — termini, stop counts, and the communes and transit
16
- stations each line serves. A **multi-operator** dataset; v1 ships **50 ETUSA lines**
17
- (Alger). Shipped as JSON and CSV. Part of [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
18
-
19
- > **Operator (source):** ETUSA — Établissement de transport urbain et suburbain d'Alger.
20
- > More cities/operators will be added under the same schema. For intercity coach stations
21
- > see [`@geoalgeria/gares-routieres`](https://www.npmjs.com/package/@geoalgeria/gares-routieres);
22
- > for rail/tram/metro see [`@geoalgeria/ferroviaire`](https://www.npmjs.com/package/@geoalgeria/ferroviaire).
5
+ Reviewed urban and suburban bus data for Algeria. This release contains **153 Lines**
6
+ from 14 Operators, **76 drawable shapes**, **128 Directions**, and **1,603 Stations**.
23
7
 
24
8
  ```bash
25
9
  npm install @geoalgeria/buses
@@ -28,62 +12,74 @@ npm install @geoalgeria/buses
28
12
  ```js
29
13
  import buses from "@geoalgeria/buses";
30
14
 
31
- const all = buses.lines(); // 50
32
- const etusa = buses.linesByOperator("ETUSA"); // 50
33
- const l1 = buses.lineById("etusa-1"); // El Harrach ↔ Place Aïssat Idir
15
+ const lines = buses.lines(); // 153
16
+ const shape = buses.shapeForLine("etusa-1");
17
+ const stops = buses.stationsByLine("etusa-1");
18
+ const directions = buses.directionsByLine("etusa-1");
34
19
  ```
35
20
 
36
- ## What's inside
37
-
38
- | Dataset | Count | Notes |
39
- | --- | --- | --- |
40
- | Urban bus lines | **50** | ETUSA (Alger) — termini, stop count, communes & stations served |
41
-
42
- > **Scope (v1):** line-level attributes only. Per-stop and per-line **geometry**
43
- > (OSM `route=bus`) is deferred to **v1.1** — ETUSA-tagged OSM route coverage is
44
- > currently thin. This covers 50 of ~122 ETUSA passenger lines. `wilaya_code` is `16`
45
- > (Alger) and joins the [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) model.
46
-
47
- ## Record shape
48
-
49
- ```json
50
- {
51
- "id": "etusa-1",
52
- "name": "Ligne 1 — El Harrach ↔ Place Aïssat Idir, via Haï El Badr",
53
- "wilaya_code": "16",
54
- "commune_code": null,
55
- "commune": null,
56
- "lat": null,
57
- "lng": null,
58
- "geo_precision": null,
59
- "geo_method": null,
60
- "source": "wikipedia",
61
- "operator": "ETUSA",
62
- "network": "Alger",
63
- "line": "1",
64
- "terminus1": "El Harrach",
65
- "terminus2": "Place Aïssat Idir, via Haï El Badr",
66
- "stops": 16,
67
- "communes_served": ["El Harrach", "Bachdjerrah", "Hussein Dey (Gare routière du Caroubier)", "El Magharia", "Belouizdad", "Sidi M'Hamed"],
68
- "stations_served": ["El Harrach Centre", "Haï El Badr", "Cité Mer et Soleil", "Cité Amirouche", "Les Fusillés", "Aïssat Idir"],
69
- "source_url": "https://fr.wikipedia.org/wiki/Lignes_de_bus_ETUSA_de_1_à_99"
70
- }
71
- ```
72
-
73
- `commune_code` and `commune` are always `null` for this dataset — a line spans several
74
- communes (see `communes_served`), so no single commune applies. `lat`/`lng`/`geo_precision`/
75
- `geo_method` are always `null` too: these are line records with no per-line geometry (see
76
- Scope below).
77
-
78
- ## Source & license
79
-
80
- Line data comes from **fr.wikipedia** (the ETUSA line articles) — licensed
81
- **CC BY-SA 4.0** (attribution + share-alike). Operator: **ETUSA**. Package code is
82
- [MIT](LICENSE); the line data inherits Wikipedia's CC BY-SA — keep attribution and
83
- share-alike if you redistribute. Verify with ETUSA for authoritative, current lines.
21
+ ## Coverage
22
+
23
+ | Operator | Lines | Shapes |
24
+ | --- | ---: | ---: |
25
+ | ETUSA (Alger) | 76 | 61 |
26
+ | ETUS Aïn Defla | 16 | 1 |
27
+ | ETUS Tlemcen | 10 | 0 |
28
+ | ETUS Sidi Bel Abbès | 8 | 0 |
29
+ | ETUS Tiaret | 7 | 7 |
30
+ | ETUS Annaba | 6 | 0 |
31
+ | ETUSTO (Tizi Ouzou) | 5 | 3 |
32
+ | ETUS Béjaïa | 5 | 0 |
33
+ | ETUS Setif | 5 | 3 |
34
+ | ETUS Oum El Bouaghi | 5 | 0 |
35
+ | ETUS M'Sila | 4 | 0 |
36
+ | ETUL Laghouat | 4 | 0 |
37
+ | ETUS Mostaganem | 1 | 1 |
38
+ | ETO Oran | 1 | 0 |
39
+
40
+ The 50 existing ETUSA Line ids are preserved (`etusa-1`, etc.). New ids use
41
+ `{operator-id}-{ref}`. Official-only Lines remain queryable even when no reusable
42
+ shape is available. Shapes are reconciled only where a reusable candidate matches a
43
+ reviewed Line identity. Tiaret ref 33 is excluded because the current official page
44
+ lists refs 26–32. Unresolved, taxi, cross/inter-wilaya, unmatched Sétif, ETUAD, and
45
+ validation-only official geometry are not published as shapes.
46
+
47
+ ## Files
48
+
49
+ - `data/lines.json` and `data/csv/lines.csv` — 153 Lines
50
+ - `data/shapes.json` and `data/geojson/shapes.geojson` — 76 MultiLineString shapes
51
+ - `data/directions.json` — 128 source OSM Direction relations
52
+ - `data/stations.json`, CSV and GeoJSON — 1,603 Station nodes
53
+ - `data/station-memberships.json` — 2,685 ordered relation memberships
54
+ - `data/operators.json` — 14 Operators
55
+
56
+ Membership order is the raw OSM relation member order and carries
57
+ `sequence_status: "osm_member_order_unvalidated"`. It is **not** a validated passenger
58
+ stop sequence. Repeated members are retained, Direction order is never reversed, and
59
+ terminus roles are not inferred. OSM `from`, `to`, and `via` remain source labels only.
60
+
61
+ Unnamed OSM Stations keep `name`, `name_fr`, and `name_ar` as `null`. Twelve ETUSA
62
+ Station nodes without a spatial Wilaya assignment are explicitly derived to Wilaya 16
63
+ through the reviewed ETUSA Operator scope and marked `wilaya_method: "operator_scope"`.
64
+
65
+ ## Sources and licences
66
+
67
+ ETUSA Line attributes come from French Wikipedia under **CC BY-SA 4.0**. Shapes,
68
+ Directions, Stations, and memberships come from a reviewed OpenStreetMap snapshot under
69
+ **ODbL 1.0** with attribution **© OpenStreetMap contributors**. The tracked source
70
+ includes the Overpass queries, retrieval interval, upstream response hashes, and a hash
71
+ of the promoted selection, so regeneration is offline and reproducible.
72
+
73
+ ETUS Tiaret, ETUSTO, ETUS Béjaïa, ETUS M'Sila, ETUS Sidi Bel Abbès, ETUS Setif,
74
+ ETUS Aïn Defla, ETUS Annaba, ETUS Tlemcen, ETO Oran, ETUS Oum El Bouaghi, and
75
+ ETUL Laghouat Line facts come from official Operator pages, APIs, programs, and
76
+ maps. Sidi Bel Abbès includes complete bidirectional
77
+ departure lists from owner-supplied official HTML; the page did not state their service
78
+ days, so `days` remains `null`. Béjaïa embedded maps, M'Sila route diagrams, and Sidi Bel
79
+ Abbès route images and Setif announcement artwork are validation-only; their geometry is not redistributed.
80
+ The official source materials do not state an open reuse licence.
81
+
82
+ Package code is MIT. Data licences and attribution requirements are detailed in
83
+ [NOTICE](NOTICE); verify current service with the relevant Operator.
84
84
 
85
85
  [Browse all packages →](https://geoalgeria.com/data)
86
-
87
- ---
88
-
89
- Made by [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)