@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 +15 -0
- package/NOTICE +27 -0
- package/README.ar.md +20 -15
- package/README.fr.md +25 -18
- package/README.md +69 -73
- package/data/csv/lines.csv +154 -51
- package/data/csv/stations.csv +1604 -0
- package/data/directions.json +1927 -0
- package/data/geojson/shapes.geojson +257513 -0
- package/data/geojson/stations.geojson +66707 -0
- package/data/lines.json +7189 -844
- package/data/metadata.json +167 -18
- package/data/operators.json +245 -0
- package/data/shapes.json +257206 -0
- package/data/station-memberships.json +32222 -0
- package/data/stations.json +50674 -0
- package/dataset-metadata.json +43 -8
- package/index.js +24 -2
- package/package.json +5 -3
- package/types/index.d.ts +174 -58
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
|
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
10
10
|
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
11
|
-
[](LICENSE)
|
|
12
12
|
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
15
|
<div dir="rtl">
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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(); //
|
|
36
|
-
const etusa = buses.linesByOperator("ETUSA"); //
|
|
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
|
-
|
|
|
45
|
+
| الخطوط | **153** | 14 مشغلًا؛ تبقى الخطوط الرسمية بدون مسار متاحة في الدليل |
|
|
46
|
+
| المسارات | **76** | مسارات OSM مراجعة |
|
|
47
|
+
| الاتجاهات | **128** | علاقات OSM المصدرية |
|
|
48
|
+
| المحطات | **1,603** | عقد OSM مع الحفاظ على الأسماء الفارغة |
|
|
46
49
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
> تغطي 50 من ~122 خطًّا لركّاب ETUSA. `wilaya_code` = `16` (الجزائر).
|
|
50
|
+
ترتيب العضويات البالغ عددها 2,685 هو ترتيب أعضاء علاقة OSM الخام ويحمل القيمة
|
|
51
|
+
`osm_member_order_unvalidated`؛ وليس ترتيب ركوب متحققًا ولا نستنتج منه المحطات الطرفية.
|
|
50
52
|
|
|
51
53
|
## المصدر والرخصة
|
|
52
54
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
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
|
|
7
|
+
**Les réseaux de bus urbains d'Algérie, en données prêtes à installer.**
|
|
8
8
|
|
|
9
9
|
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
10
10
|
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
11
|
-
[](LICENSE)
|
|
12
12
|
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
|
-
Les **lignes** de bus urbains d'Algérie
|
|
16
|
-
|
|
17
|
-
|
|
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
|
-
>
|
|
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(); //
|
|
32
|
-
const etusa = buses.linesByOperator("ETUSA"); //
|
|
33
|
-
const
|
|
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
|
|
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
|
-
|
|
43
|
-
|
|
44
|
-
|
|
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
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
-
|
|
8
|
-
|
|
9
|
-
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
10
|
-
[](https://www.npmjs.com/package/@geoalgeria/buses)
|
|
11
|
-
[](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
|
|
32
|
-
const
|
|
33
|
-
const
|
|
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
|
-
##
|
|
37
|
-
|
|
38
|
-
|
|
|
39
|
-
| --- |
|
|
40
|
-
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
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)
|