@geoalgeria/buses 2.2.2 → 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 CHANGED
@@ -15,7 +15,7 @@
15
15
  <div dir="rtl">
16
16
 
17
17
  بيانات مراجعة لخطوط الحافلات الحضرية وشبه الحضرية: **184 خطًا** و**76 مسارًا** و**128 اتجاهًا**
18
- و**1,603 محطة** لدى 16 مشغّلًا.
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,603** | عقد OSM مع الحفاظ على الأسماء الفارغة |
48
+ | المحطات | **1,599** | عقد OSM مع الحفاظ على الأسماء الفارغة |
49
49
 
50
- ترتيب العضويات البالغ عددها 2,685 هو ترتيب أعضاء علاقة OSM الخام ويحمل القيمة
51
- `osm_member_order_unvalidated`؛ وليس ترتيب ركوب متحققًا ولا نستنتج منه المحطات الطرفية.
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 603 stations** pour 16 exploitants. En JSON,
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 603** | Nœuds OSM, noms nuls conservés |
43
-
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.
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,603 Stations**.
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,603 Station nodes
55
- - `data/station-memberships.json`: 2,685 ordered relation memberships
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 and carries
59
- `sequence_status: "osm_member_order_unvalidated"`. It is **not** a validated passenger
60
- stop sequence. Repeated members are retained, Direction order is never reversed, and
61
- terminus roles are not inferred. OSM `from`, `to`, and `via` remain source labels only.
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