@geoalgeria/buses 2.2.3 → 2.3.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/README.ar.md +23 -4
- package/README.fr.md +30 -6
- package/README.md +31 -7
- package/data/csv/lines.csv +185 -185
- package/data/csv/stations.csv +410 -414
- package/data/directions.json +105 -105
- package/data/geojson/shapes.geojson +4967 -2615
- package/data/geojson/stations.geojson +490 -648
- package/data/lines.json +368 -184
- package/data/metadata.json +8 -8
- package/data/shapes.json +4967 -2615
- package/data/station-memberships.json +3617 -3653
- package/data/stations.json +455 -573
- package/dataset-metadata.json +2 -2
- package/package.json +2 -2
- package/types/index.d.ts +10 -1
package/README.ar.md
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
<div dir="rtl">
|
|
16
16
|
|
|
17
17
|
بيانات مراجعة لخطوط الحافلات الحضرية وشبه الحضرية: **184 خطًا** و**76 مسارًا** و**128 اتجاهًا**
|
|
18
|
-
و**1,
|
|
18
|
+
و**1,599 محطة** لدى 16 مشغّلًا.
|
|
19
19
|
بصيغ JSON وCSV وGeoJSON. جزء من
|
|
20
20
|
[GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
|
|
21
21
|
|
|
@@ -45,10 +45,29 @@ const etusa = buses.linesByOperator("ETUSA"); // 76
|
|
|
45
45
|
| الخطوط | **184** | 16 مشغلًا؛ تبقى الخطوط الرسمية بدون مسار متاحة في الدليل |
|
|
46
46
|
| المسارات | **76** | مسارات OSM مراجعة |
|
|
47
47
|
| الاتجاهات | **128** | علاقات OSM المصدرية |
|
|
48
|
-
| المحطات | **1,
|
|
48
|
+
| المحطات | **1,599** | عقد OSM مع الحفاظ على الأسماء الفارغة |
|
|
49
49
|
|
|
50
|
-
ترتيب العضويات البالغ عددها 2,
|
|
51
|
-
|
|
50
|
+
ترتيب العضويات البالغ عددها 2,682 هو ترتيب أعضاء علاقة OSM الخام، وليس ترتيب ركوب متحققًا
|
|
51
|
+
ولا نستنتج منه المحطات الطرفية. يحمل كل اتجاه، وكل عضوية فيه، الحقل `sequence_status` الناتج
|
|
52
|
+
عن فحص هندسي لهذا الترتيب مقارنةً بالمسار المرسوم:
|
|
53
|
+
|
|
54
|
+
| `sequence_status` | الاتجاهات | المعنى |
|
|
55
|
+
| --- | ---: | --- |
|
|
56
|
+
| `osm_member_order_consistent` | 36 | المحطات قريبة من المسار ومتتالية على امتداده، والأولى والأخيرة قرب طرفيه، والمسار متصل |
|
|
57
|
+
| `osm_member_order_inconsistent` | 69 | فشل فحص واحد على الأقل؛ يُنشر الاتجاه مع هذه الإشارة |
|
|
58
|
+
| `osm_member_order_unvalidated` | 23 | أقل من محطتين، فلا يمكن فحص الترتيب |
|
|
59
|
+
|
|
60
|
+
الاتساق يعني أن ترتيب OSM يوافق مسار OSM، لا أن المشغّل أكّده. قد تُضاف قيم أخرى في إصدار
|
|
61
|
+
فرعي، لذا يحتاج كل `switch` على `sequence_status` إلى فرع `default`.
|
|
62
|
+
|
|
63
|
+
لا يحمل الخط حالة خاصة به، وإنما تُستنتج حالته من اتجاهاته. فالخط الذي لا اتجاه له لا مسار له بعد،
|
|
64
|
+
وعددها 108 من 184: إما لم يُعثر له على علاقة OSM، وإما له علاقة OSM توافقه ولم تُعتمد بعد، وإما
|
|
65
|
+
ليس له سوى قائمة محطات من المشغّل بلا مسار. أما الخط الذي له اتجاهات فتُقرأ قوّته من حالات اتجاهاته.
|
|
66
|
+
|
|
67
|
+
الحقل `last_confirmed` في كل خط، ويُنسخ إلى مساره، هو تاريخ المصدر الرسمي للمشغّل الذي يذكر الخط:
|
|
68
|
+
تاريخ الوثيقة نفسها إن حملت تاريخًا، وإلا يوم قراءتها أو تقديمها. وقيمته `null` في الخطوط الـ77
|
|
69
|
+
التي لا تذكرها إلا ويكيبيديا أو OpenStreetMap (خطوط ETUSA ومستغانم). ولا تعني القيمة `null` أن
|
|
70
|
+
الخط توقّف عن العمل، ولا يغيّر أي تحديث لـ OSM هذا التاريخ.
|
|
52
71
|
|
|
53
72
|
## المصدر والرخصة
|
|
54
73
|
|
package/README.fr.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
15
|
Les **lignes** de bus urbains et suburbains d'Algérie. Cette version livre **184 lignes**,
|
|
16
|
-
**76 tracés**, **128 directions** et **1
|
|
16
|
+
**76 tracés**, **128 directions** et **1 599 stations** pour 16 exploitants. En JSON,
|
|
17
17
|
CSV et GeoJSON. Fait partie de
|
|
18
18
|
[GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
|
|
19
19
|
|
|
@@ -39,11 +39,35 @@ const trace = buses.shapeForLine("etusa-1");
|
|
|
39
39
|
| Lignes | **184** | 16 exploitants ; lignes officielles sans tracé conservées dans l'annuaire |
|
|
40
40
|
| Tracés OSM | **76** | 61 ETUSA + 15 lignes des autres exploitants |
|
|
41
41
|
| Directions | **128** | Relations OSM sources |
|
|
42
|
-
| Stations | **1
|
|
43
|
-
|
|
44
|
-
L'ordre des 2
|
|
45
|
-
|
|
46
|
-
|
|
42
|
+
| Stations | **1 599** | Nœuds OSM, noms nuls conservés |
|
|
43
|
+
|
|
44
|
+
L'ordre des 2 682 appartenances est l'ordre brut des membres OSM : il ne constitue pas
|
|
45
|
+
un ordre voyageurs validé et aucun terminus n'est déduit automatiquement. Chaque direction,
|
|
46
|
+
et chacune de ses appartenances, porte un `sequence_status` issu de contrôles géométriques
|
|
47
|
+
de cet ordre par rapport au tracé :
|
|
48
|
+
|
|
49
|
+
| `sequence_status` | Directions | Signification |
|
|
50
|
+
| --- | ---: | --- |
|
|
51
|
+
| `osm_member_order_consistent` | 36 | Les stations sont proches du tracé et se suivent dans son sens, la première et la dernière près de ses extrémités, et le tracé est continu |
|
|
52
|
+
| `osm_member_order_inconsistent` | 69 | Au moins un de ces contrôles échoue ; la direction est publiée avec ce signalement |
|
|
53
|
+
| `osm_member_order_unvalidated` | 23 | Moins de deux stations : l'ordre ne peut pas être contrôlé |
|
|
54
|
+
|
|
55
|
+
Cohérent signifie que l'ordre OSM concorde avec le tracé OSM, pas qu'un exploitant l'a
|
|
56
|
+
confirmé. D'autres valeurs peuvent s'ajouter dans une version mineure : prévoyez une branche
|
|
57
|
+
`default` dans tout `switch` sur `sequence_status`.
|
|
58
|
+
|
|
59
|
+
Une ligne n'a pas de statut propre : il se lit dans ses directions. Une ligne sans
|
|
60
|
+
direction n'a pas encore de tracé (108 sur 184 : aucune relation OSM trouvée, une relation
|
|
61
|
+
OSM qui correspond à la ligne mais n'est pas encore approuvée, ou seulement une liste
|
|
62
|
+
d'arrêts de l'exploitant, sans tracé). Une ligne qui a des directions vaut ce que valent
|
|
63
|
+
leurs statuts.
|
|
64
|
+
|
|
65
|
+
`last_confirmed`, sur chaque ligne et recopié sur son tracé, est la date de la source
|
|
66
|
+
officielle de l'exploitant qui cite la ligne : la date du document quand il en porte une,
|
|
67
|
+
sinon le jour où il a été lu ou fourni. Il vaut `null` pour les 77 lignes que seuls
|
|
68
|
+
Wikipédia ou OpenStreetMap nomment (celles d'ETUSA et de Mostaganem). Un `null` ne
|
|
69
|
+
signifie pas que la ligne a cessé de circuler, et une mise à jour OSM ne modifie jamais
|
|
70
|
+
la date.
|
|
47
71
|
|
|
48
72
|
## Source & licence
|
|
49
73
|
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# @geoalgeria/buses
|
|
4
4
|
|
|
5
5
|
Reviewed urban and suburban bus data for Algeria. This release contains **184 Lines**
|
|
6
|
-
from 16 Operators, **76 drawable shapes**, **128 Directions**, and **1,
|
|
6
|
+
from 16 Operators, **76 drawable shapes**, **128 Directions**, and **1,599 Stations**.
|
|
7
7
|
|
|
8
8
|
```bash
|
|
9
9
|
npm install @geoalgeria/buses
|
|
@@ -51,14 +51,38 @@ validation-only official geometry are not published as shapes.
|
|
|
51
51
|
- `data/lines.json` and `data/csv/lines.csv`: 184 Lines
|
|
52
52
|
- `data/shapes.json` and `data/geojson/shapes.geojson`: 76 MultiLineString shapes
|
|
53
53
|
- `data/directions.json`: 128 source OSM Direction relations
|
|
54
|
-
- `data/stations.json`, CSV and GeoJSON: 1,
|
|
55
|
-
- `data/station-memberships.json`: 2,
|
|
54
|
+
- `data/stations.json`, CSV and GeoJSON: 1,599 Station nodes
|
|
55
|
+
- `data/station-memberships.json`: 2,682 ordered relation memberships
|
|
56
56
|
- `data/operators.json`: 16 Operators
|
|
57
57
|
|
|
58
|
-
Membership order is the raw OSM relation member order
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
58
|
+
Membership order is the raw OSM relation member order. It is **not** a validated
|
|
59
|
+
passenger stop sequence. Repeated members are retained, Direction order is never
|
|
60
|
+
reversed, and terminus roles are not inferred. OSM `from`, `to`, and `via` remain source
|
|
61
|
+
labels only.
|
|
62
|
+
|
|
63
|
+
Each Direction, and each of its Memberships, carries a `sequence_status` from geometric
|
|
64
|
+
checks of that order against the drawn path:
|
|
65
|
+
|
|
66
|
+
| `sequence_status` | Directions | Meaning |
|
|
67
|
+
| --- | ---: | --- |
|
|
68
|
+
| `osm_member_order_consistent` | 36 | Stations lie near the path, in order along it, with the first and last near its ends, and the path has no gap |
|
|
69
|
+
| `osm_member_order_inconsistent` | 69 | At least one of those checks fails; the Direction is published, flagged |
|
|
70
|
+
| `osm_member_order_unvalidated` | 23 | Fewer than two Stations, so the order cannot be checked |
|
|
71
|
+
|
|
72
|
+
Consistent means the OSM order agrees with the OSM path, not that an Operator confirms
|
|
73
|
+
it. More values may be added in a minor release, so a `switch` over `sequence_status`
|
|
74
|
+
needs a `default` branch.
|
|
75
|
+
|
|
76
|
+
A Line has no status of its own: read it from its Directions. A Line with no Direction
|
|
77
|
+
has no geometry yet (108 of 184: no OSM relation found, an OSM relation that matches the
|
|
78
|
+
Line but is not yet approved, or only an Operator stop list with no geometry). A Line
|
|
79
|
+
with Directions is as strong as the statuses they carry.
|
|
80
|
+
|
|
81
|
+
`last_confirmed` on each Line, copied onto its shape, is the date of the official
|
|
82
|
+
Operator source that states the Line: the document's own date when it carries one,
|
|
83
|
+
otherwise the day it was read or supplied. It is `null` for the 77 Lines that only
|
|
84
|
+
Wikipedia or OpenStreetMap name (ETUSA's and Mostaganem's). A null does not mean the Line
|
|
85
|
+
stopped running, and an OSM refresh never moves the date.
|
|
62
86
|
|
|
63
87
|
Unnamed OSM Stations keep `name`, `name_fr`, and `name_ar` as `null`. Twelve ETUSA
|
|
64
88
|
Station nodes without a spatial Wilaya assignment are explicitly derived to Wilaya 16
|