@golemio/parkings 1.6.0 → 1.6.1-dev.1022513268

package/docs/implementation-documentation.md

@@ -10,6 +10,7 @@ Modul slouží k ukládání a poskytování informací o parkování.
 - TSK (Praha)
 - IPR (Praha)
 - IPT/OICT
+- TSK (Praha) API v2
 
 ## Vstupní data
 
@@ -24,7 +25,7 @@ Modul slouží k ukládání a poskytování informací o parkování.
 
 ### Data aktivně stahujeme
 
-Data stahujeme pravidelně od IPR, TSK.
+Data stahujeme pravidelně od IPR, TSK a z nového API TSK (značené jako v2).
 
 Pro ZTP parkoviště se z API se stahuje JSON z https://opendata.iprpraha.cz/CUR/DOP/DOP_TSK_Stani_ZTP_b/WGS_84/DOP_TSK_Stani_ZTP_b.json
 
@@ -35,6 +36,7 @@ Pro statické (ručně vytvořené) polygony placených parkovišť se stahuje G
 #### Zóny placeného stání
 
 Zóny placeného stání používají 2 datové zdroje - TSK a Opendata IPR, které mají přesnější geometrii.
+Další datový zdroj zón je API TSK (CIS VHD CD API) značené jako v2
 
 - zdroj dat (**TSK**):
 
@@ -93,6 +95,48 @@ Zóny placeného stání používají 2 datové zdroje - TSK a Opendata IPR, kte
 - název rabbitmq fronty
     - dataplatform.parkings.saveParkingZonesPrague
 
+- zdroj dat (**TSK v2**):
+
+  config HTTPProtocolStrategy:
+
+  ```
+    headers: {
+        Authorization: `Basic jmeno:heslo`,
+    },
+    method: "GET",
+    url: this.config.datasources.parking.TskApiBaseUrl + this.config.datasources.parking.TskApiEndpoints[endpoint],
+  ```
+
+- formát dat (**TSK v2**)
+
+    - zdroj používá 3 datové soubory: sections, sectionList level 251 (zóny plac. stání) a level 253 (ZTP)
+    - protokol: http
+    - datový typ: json
+    - validační schéma sections: https://gitlab.com/operator-ict/golemio/code/modules/parkings/-/blob/development/src/schema-definitions/datasources/TskParkingSectionSchema.ts
+    - validační schéma sections level (251 i 253): https://gitlab.com/operator-ict/golemio/code/modules/parkings/-/blob/development/src/schema-definitions/datasources/TskParkingSectionLevelSchema.ts
+
+- frekvence stahování
+
+    - cron definice:
+        - cron.dataplatform.parkings.saveParkingZonesPrague (`0 0 4 * * *`)
+
+#### Parkovací automaty TSK
+
+- zdroj dat (**TSK v2**) je stejný, jako pro zóny, liší se jen konec URL: "ParkMachine/list"
+
+- formát dat (**TSK v2**)
+
+    - protokol: http
+    - datový typ: json
+    - validační schéma: https://gitlab.com/operator-ict/golemio/code/modules/parkings/-/blob/development/src/schema-definitions/datasources/TskParkingMachinesSchema.ts
+
+- frekvence stahování
+
+    - cron definice:
+        - cron.dataplatform.parkings.saveParkingZonesPrague (`0 0 4 * * *`)
+
+- cílová tabulka: `parking_machines`
+
 #### Placené parkoviště
 
 - zdroj dat (**TSK**):

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/parkings",
-    "version": "1.6.0",
+    "version": "1.6.1-dev.1022513268",
     "description": "Golemio Parkings Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -44,6 +44,7 @@
         "@types/node": "^18.13.0",
         "@types/sinon": "^9.0.10",
         "@types/supertest": "^2.0.10",
+        "@types/terraformer__wkt": "^2.0.0",
         "body-parser": "^1.19.0",
         "body-parser-xml": "^2.0.0",
         "chai": "4.2.0",
@@ -73,6 +74,7 @@
         "@golemio/core": ">=1.9.0"
     },
     "dependencies": {
+        "@terraformer/wkt": "^2.2.0",
         "@turf/turf": "^6.5.0",
         "uuid-by-string": "^3.0.2"
     }