@loaders.gl/ogc 0.0.0-stage → 5.0.0-alpha.14

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.
Files changed (383) hide show
  1. package/LICENSE +52 -0
  2. package/README.md +10 -2
  3. package/dist/index.cjs +7052 -0
  4. package/dist/index.cjs.map +6 -0
  5. package/dist/index.d.ts +3 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +6 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/stac/index.cjs +1095 -0
  10. package/dist/stac/index.cjs.map +6 -0
  11. package/dist/stac/index.d.ts +4 -0
  12. package/dist/stac/index.d.ts.map +1 -0
  13. package/dist/stac/index.js +5 -0
  14. package/dist/stac/index.js.map +1 -0
  15. package/dist/stac/stac-source-loader-types.d.ts +44 -0
  16. package/dist/stac/stac-source-loader-types.d.ts.map +1 -0
  17. package/dist/stac/stac-source-loader-types.js +43 -0
  18. package/dist/stac/stac-source-loader-types.js.map +1 -0
  19. package/dist/stac/stac-source.cjs +1544 -0
  20. package/dist/stac/stac-source.cjs.map +6 -0
  21. package/dist/stac/stac-source.d.ts +92 -0
  22. package/dist/stac/stac-source.d.ts.map +1 -0
  23. package/dist/stac/stac-source.js +500 -0
  24. package/dist/stac/stac-source.js.map +1 -0
  25. package/dist/stac/stac-types.d.ts +213 -0
  26. package/dist/stac/stac-types.d.ts.map +1 -0
  27. package/dist/stac/stac-types.js +5 -0
  28. package/dist/stac/stac-types.js.map +1 -0
  29. package/dist/wms/bundled.cjs +7295 -0
  30. package/dist/wms/bundled.cjs.map +6 -0
  31. package/dist/wms/bundled.d.ts +24 -0
  32. package/dist/wms/bundled.d.ts.map +1 -0
  33. package/dist/wms/bundled.js +18 -0
  34. package/dist/wms/bundled.js.map +1 -0
  35. package/dist/wms/capability-graph.d.ts +42 -0
  36. package/dist/wms/capability-graph.d.ts.map +1 -0
  37. package/dist/wms/capability-graph.js +118 -0
  38. package/dist/wms/capability-graph.js.map +1 -0
  39. package/dist/wms/crs-utils.d.ts +24 -0
  40. package/dist/wms/crs-utils.d.ts.map +1 -0
  41. package/dist/wms/crs-utils.js +57 -0
  42. package/dist/wms/crs-utils.js.map +1 -0
  43. package/dist/wms/csw-capabilities-loader-with-parser.d.ts +34 -0
  44. package/dist/wms/csw-capabilities-loader-with-parser.d.ts.map +1 -0
  45. package/dist/wms/csw-capabilities-loader-with-parser.js +15 -0
  46. package/dist/wms/csw-capabilities-loader-with-parser.js.map +1 -0
  47. package/dist/wms/csw-capabilities-loader.d.ts +56 -0
  48. package/dist/wms/csw-capabilities-loader.d.ts.map +1 -0
  49. package/dist/wms/csw-capabilities-loader.js +38 -0
  50. package/dist/wms/csw-capabilities-loader.js.map +1 -0
  51. package/dist/wms/csw-domain-loader-with-parser.d.ts +33 -0
  52. package/dist/wms/csw-domain-loader-with-parser.d.ts.map +1 -0
  53. package/dist/wms/csw-domain-loader-with-parser.js +15 -0
  54. package/dist/wms/csw-domain-loader-with-parser.js.map +1 -0
  55. package/dist/wms/csw-domain-loader.d.ts +55 -0
  56. package/dist/wms/csw-domain-loader.d.ts.map +1 -0
  57. package/dist/wms/csw-domain-loader.js +38 -0
  58. package/dist/wms/csw-domain-loader.js.map +1 -0
  59. package/dist/wms/csw-records-loader-with-parser.d.ts +33 -0
  60. package/dist/wms/csw-records-loader-with-parser.d.ts.map +1 -0
  61. package/dist/wms/csw-records-loader-with-parser.js +15 -0
  62. package/dist/wms/csw-records-loader-with-parser.js.map +1 -0
  63. package/dist/wms/csw-records-loader.d.ts +55 -0
  64. package/dist/wms/csw-records-loader.d.ts.map +1 -0
  65. package/dist/wms/csw-records-loader.js +38 -0
  66. package/dist/wms/csw-records-loader.js.map +1 -0
  67. package/dist/wms/csw-source-loader.d.ts +165 -0
  68. package/dist/wms/csw-source-loader.d.ts.map +1 -0
  69. package/dist/wms/csw-source-loader.js +203 -0
  70. package/dist/wms/csw-source-loader.js.map +1 -0
  71. package/dist/wms/feature-pagination.d.ts +34 -0
  72. package/dist/wms/feature-pagination.d.ts.map +1 -0
  73. package/dist/wms/feature-pagination.js +159 -0
  74. package/dist/wms/feature-pagination.js.map +1 -0
  75. package/dist/wms/gml-loader-types.d.ts +68 -0
  76. package/dist/wms/gml-loader-types.d.ts.map +1 -0
  77. package/dist/wms/gml-loader-types.js +38 -0
  78. package/dist/wms/gml-loader-types.js.map +1 -0
  79. package/dist/wms/gml-loader.cjs +5779 -0
  80. package/dist/wms/gml-loader.cjs.map +6 -0
  81. package/dist/wms/gml-loader.d.ts +38 -0
  82. package/dist/wms/gml-loader.d.ts.map +1 -0
  83. package/dist/wms/gml-loader.js +195 -0
  84. package/dist/wms/gml-loader.js.map +1 -0
  85. package/dist/wms/index.cjs +12416 -0
  86. package/dist/wms/index.cjs.map +6 -0
  87. package/dist/wms/index.d.ts +61 -0
  88. package/dist/wms/index.d.ts.map +1 -0
  89. package/dist/wms/index.js +36 -0
  90. package/dist/wms/index.js.map +1 -0
  91. package/dist/wms/lib/deprecated/create-image-source.d.ts +27 -0
  92. package/dist/wms/lib/deprecated/create-image-source.d.ts.map +1 -0
  93. package/dist/wms/lib/deprecated/create-image-source.js +44 -0
  94. package/dist/wms/lib/deprecated/create-image-source.js.map +1 -0
  95. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts +14 -0
  96. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts.map +1 -0
  97. package/dist/wms/lib/deprecated/image-source-compatibility.js +21 -0
  98. package/dist/wms/lib/deprecated/image-source-compatibility.js.map +1 -0
  99. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts +79 -0
  100. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts.map +1 -0
  101. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js +23 -0
  102. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js.map +1 -0
  103. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts +17 -0
  104. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts.map +1 -0
  105. package/dist/wms/lib/parsers/csw/parse-csw-domain.js +32 -0
  106. package/dist/wms/lib/parsers/csw/parse-csw-domain.js.map +1 -0
  107. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts +34 -0
  108. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts.map +1 -0
  109. package/dist/wms/lib/parsers/csw/parse-csw-records.js +56 -0
  110. package/dist/wms/lib/parsers/csw/parse-csw-records.js.map +1 -0
  111. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts +6 -0
  112. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts.map +1 -0
  113. package/dist/wms/lib/parsers/csw/parse-exception-report.js +29 -0
  114. package/dist/wms/lib/parsers/csw/parse-exception-report.js.map +1 -0
  115. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts +3 -0
  116. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts.map +1 -0
  117. package/dist/wms/lib/parsers/gml/deep-strict-equal.js +118 -0
  118. package/dist/wms/lib/parsers/gml/deep-strict-equal.js.map +1 -0
  119. package/dist/wms/lib/parsers/gml/parse-gml.d.ts +66 -0
  120. package/dist/wms/lib/parsers/gml/parse-gml.d.ts.map +1 -0
  121. package/dist/wms/lib/parsers/gml/parse-gml.js +641 -0
  122. package/dist/wms/lib/parsers/gml/parse-gml.js.map +1 -0
  123. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts +4 -0
  124. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts.map +1 -0
  125. package/dist/wms/lib/parsers/gml/rewind-geometry.js +45 -0
  126. package/dist/wms/lib/parsers/gml/rewind-geometry.js.map +1 -0
  127. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts +19 -0
  128. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts.map +1 -0
  129. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js +74 -0
  130. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js.map +1 -0
  131. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts +63 -0
  132. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts.map +1 -0
  133. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js +82 -0
  134. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js.map +1 -0
  135. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts +97 -0
  136. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts.map +1 -0
  137. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js +60 -0
  138. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js.map +1 -0
  139. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts +7 -0
  140. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts.map +1 -0
  141. package/dist/wms/lib/parsers/wfs/parse-wfs.js +31 -0
  142. package/dist/wms/lib/parsers/wfs/parse-wfs.js.map +1 -0
  143. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts +126 -0
  144. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts.map +1 -0
  145. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js +232 -0
  146. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js.map +1 -0
  147. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts +8 -0
  148. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts.map +1 -0
  149. package/dist/wms/lib/parsers/wms/parse-wms-error.js +21 -0
  150. package/dist/wms/lib/parsers/wms/parse-wms-error.js.map +1 -0
  151. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts +20 -0
  152. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts.map +1 -0
  153. package/dist/wms/lib/parsers/wms/parse-wms-features.js +26 -0
  154. package/dist/wms/lib/parsers/wms/parse-wms-features.js.map +1 -0
  155. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts +11 -0
  156. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts.map +1 -0
  157. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js +14 -0
  158. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js.map +1 -0
  159. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts +101 -0
  160. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  161. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js +175 -0
  162. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js.map +1 -0
  163. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts +11 -0
  164. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts.map +1 -0
  165. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js +63 -0
  166. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js.map +1 -0
  167. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts +4 -0
  168. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts.map +1 -0
  169. package/dist/wms/lib/parsers/xml/parse-xml-text.js +9 -0
  170. package/dist/wms/lib/parsers/xml/parse-xml-text.js.map +1 -0
  171. package/dist/wms/lib/tile-grid.d.ts +14 -0
  172. package/dist/wms/lib/tile-grid.d.ts.map +1 -0
  173. package/dist/wms/lib/tile-grid.js +28 -0
  174. package/dist/wms/lib/tile-grid.js.map +1 -0
  175. package/dist/wms/managed-vector-source.d.ts +66 -0
  176. package/dist/wms/managed-vector-source.d.ts.map +1 -0
  177. package/dist/wms/managed-vector-source.js +307 -0
  178. package/dist/wms/managed-vector-source.js.map +1 -0
  179. package/dist/wms/ogc-api-coverages-source-loader.d.ts +64 -0
  180. package/dist/wms/ogc-api-coverages-source-loader.d.ts.map +1 -0
  181. package/dist/wms/ogc-api-coverages-source-loader.js +78 -0
  182. package/dist/wms/ogc-api-coverages-source-loader.js.map +1 -0
  183. package/dist/wms/ogc-api-edr-source-loader.d.ts +72 -0
  184. package/dist/wms/ogc-api-edr-source-loader.d.ts.map +1 -0
  185. package/dist/wms/ogc-api-edr-source-loader.js +82 -0
  186. package/dist/wms/ogc-api-edr-source-loader.js.map +1 -0
  187. package/dist/wms/ogc-api-source-loader.d.ts +223 -0
  188. package/dist/wms/ogc-api-source-loader.d.ts.map +1 -0
  189. package/dist/wms/ogc-api-source-loader.js +517 -0
  190. package/dist/wms/ogc-api-source-loader.js.map +1 -0
  191. package/dist/wms/service-capabilities.d.ts +17 -0
  192. package/dist/wms/service-capabilities.d.ts.map +1 -0
  193. package/dist/wms/service-capabilities.js +110 -0
  194. package/dist/wms/service-capabilities.js.map +1 -0
  195. package/dist/wms/service-runtime.d.ts +67 -0
  196. package/dist/wms/service-runtime.d.ts.map +1 -0
  197. package/dist/wms/service-runtime.js +165 -0
  198. package/dist/wms/service-runtime.js.map +1 -0
  199. package/dist/wms/unbundled.cjs +5995 -0
  200. package/dist/wms/unbundled.cjs.map +6 -0
  201. package/dist/wms/unbundled.d.ts +18 -0
  202. package/dist/wms/unbundled.d.ts.map +1 -0
  203. package/dist/wms/unbundled.js +12 -0
  204. package/dist/wms/unbundled.js.map +1 -0
  205. package/dist/wms/wcs-source-loader.d.ts +99 -0
  206. package/dist/wms/wcs-source-loader.d.ts.map +1 -0
  207. package/dist/wms/wcs-source-loader.js +178 -0
  208. package/dist/wms/wcs-source-loader.js.map +1 -0
  209. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts +35 -0
  210. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts.map +1 -0
  211. package/dist/wms/wfs-capabilities-loader-with-parser.js +17 -0
  212. package/dist/wms/wfs-capabilities-loader-with-parser.js.map +1 -0
  213. package/dist/wms/wfs-capabilities-loader.d.ts +59 -0
  214. package/dist/wms/wfs-capabilities-loader.d.ts.map +1 -0
  215. package/dist/wms/wfs-capabilities-loader.js +42 -0
  216. package/dist/wms/wfs-capabilities-loader.js.map +1 -0
  217. package/dist/wms/wfs-source-loader.d.ts +353 -0
  218. package/dist/wms/wfs-source-loader.d.ts.map +1 -0
  219. package/dist/wms/wfs-source-loader.js +606 -0
  220. package/dist/wms/wfs-source-loader.js.map +1 -0
  221. package/dist/wms/wip/data-source.d.ts +54 -0
  222. package/dist/wms/wip/data-source.d.ts.map +1 -0
  223. package/dist/wms/wip/data-source.js +62 -0
  224. package/dist/wms/wip/data-source.js.map +1 -0
  225. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts +78 -0
  226. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts.map +1 -0
  227. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js +14 -0
  228. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js.map +1 -0
  229. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts +87 -0
  230. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  231. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js +76 -0
  232. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js.map +1 -0
  233. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts +7 -0
  234. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts.map +1 -0
  235. package/dist/wms/wip/lib/wmts/parse-wmts.js +34 -0
  236. package/dist/wms/wip/lib/wmts/parse-wmts.js.map +1 -0
  237. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts +12 -0
  238. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts.map +1 -0
  239. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js +16 -0
  240. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js.map +1 -0
  241. package/dist/wms/wip/wcs-capabilities-loader.d.ts +12 -0
  242. package/dist/wms/wip/wcs-capabilities-loader.d.ts.map +1 -0
  243. package/dist/wms/wip/wcs-capabilities-loader.js +36 -0
  244. package/dist/wms/wip/wcs-capabilities-loader.js.map +1 -0
  245. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts +7 -0
  246. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts.map +1 -0
  247. package/dist/wms/wip/wms-feature-info-loader-with-parser.js +15 -0
  248. package/dist/wms/wip/wms-feature-info-loader-with-parser.js.map +1 -0
  249. package/dist/wms/wip/wms-feature-info-loader.d.ts +7 -0
  250. package/dist/wms/wip/wms-feature-info-loader.d.ts.map +1 -0
  251. package/dist/wms/wip/wms-feature-info-loader.js +19 -0
  252. package/dist/wms/wip/wms-feature-info-loader.js.map +1 -0
  253. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts +7 -0
  254. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts.map +1 -0
  255. package/dist/wms/wip/wms-layer-description-loader-with-parser.js +15 -0
  256. package/dist/wms/wip/wms-layer-description-loader-with-parser.js.map +1 -0
  257. package/dist/wms/wip/wms-layer-description-loader.d.ts +7 -0
  258. package/dist/wms/wip/wms-layer-description-loader.d.ts.map +1 -0
  259. package/dist/wms/wip/wms-layer-description-loader.js +19 -0
  260. package/dist/wms/wip/wms-layer-description-loader.js.map +1 -0
  261. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts +11 -0
  262. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  263. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js +17 -0
  264. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js.map +1 -0
  265. package/dist/wms/wip/wmts-capabilities-loader.d.ts +11 -0
  266. package/dist/wms/wip/wmts-capabilities-loader.d.ts.map +1 -0
  267. package/dist/wms/wip/wmts-capabilities-loader.js +36 -0
  268. package/dist/wms/wip/wmts-capabilities-loader.js.map +1 -0
  269. package/dist/wms/wms-capabilities-loader-with-parser.d.ts +40 -0
  270. package/dist/wms/wms-capabilities-loader-with-parser.d.ts.map +1 -0
  271. package/dist/wms/wms-capabilities-loader-with-parser.js +19 -0
  272. package/dist/wms/wms-capabilities-loader-with-parser.js.map +1 -0
  273. package/dist/wms/wms-capabilities-loader.d.ts +62 -0
  274. package/dist/wms/wms-capabilities-loader.d.ts.map +1 -0
  275. package/dist/wms/wms-capabilities-loader.js +38 -0
  276. package/dist/wms/wms-capabilities-loader.js.map +1 -0
  277. package/dist/wms/wms-error-loader-with-parser.d.ts +39 -0
  278. package/dist/wms/wms-error-loader-with-parser.d.ts.map +1 -0
  279. package/dist/wms/wms-error-loader-with-parser.js +28 -0
  280. package/dist/wms/wms-error-loader-with-parser.js.map +1 -0
  281. package/dist/wms/wms-error-loader.d.ts +64 -0
  282. package/dist/wms/wms-error-loader.d.ts.map +1 -0
  283. package/dist/wms/wms-error-loader.js +40 -0
  284. package/dist/wms/wms-error-loader.js.map +1 -0
  285. package/dist/wms/wms-format.d.ts +13 -0
  286. package/dist/wms/wms-format.d.ts.map +1 -0
  287. package/dist/wms/wms-format.js +25 -0
  288. package/dist/wms/wms-format.js.map +1 -0
  289. package/dist/wms/wms-source-loader.d.ts +226 -0
  290. package/dist/wms/wms-source-loader.d.ts.map +1 -0
  291. package/dist/wms/wms-source-loader.js +397 -0
  292. package/dist/wms/wms-source-loader.js.map +1 -0
  293. package/dist/wms/wmts-capabilities-loader-with-parser.cjs +2189 -0
  294. package/dist/wms/wmts-capabilities-loader-with-parser.cjs.map +6 -0
  295. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts +3 -0
  296. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  297. package/dist/wms/wmts-capabilities-loader-with-parser.js +13 -0
  298. package/dist/wms/wmts-capabilities-loader-with-parser.js.map +1 -0
  299. package/dist/wms/wmts-capabilities-loader.d.ts +7 -0
  300. package/dist/wms/wmts-capabilities-loader.d.ts.map +1 -0
  301. package/dist/wms/wmts-capabilities-loader.js +24 -0
  302. package/dist/wms/wmts-capabilities-loader.js.map +1 -0
  303. package/dist/wms/wmts-source-loader.d.ts +120 -0
  304. package/dist/wms/wmts-source-loader.d.ts.map +1 -0
  305. package/dist/wms/wmts-source-loader.js +472 -0
  306. package/dist/wms/wmts-source-loader.js.map +1 -0
  307. package/package.json +89 -4
  308. package/src/index.ts +6 -0
  309. package/src/stac/index.ts +25 -0
  310. package/src/stac/stac-source-loader-types.ts +65 -0
  311. package/src/stac/stac-source.ts +635 -0
  312. package/src/stac/stac-types.ts +230 -0
  313. package/src/wms/bundled.ts +30 -0
  314. package/src/wms/capability-graph.ts +152 -0
  315. package/src/wms/crs-utils.ts +67 -0
  316. package/src/wms/csw-capabilities-loader-with-parser.ts +30 -0
  317. package/src/wms/csw-capabilities-loader.ts +54 -0
  318. package/src/wms/csw-domain-loader-with-parser.ts +28 -0
  319. package/src/wms/csw-domain-loader.ts +53 -0
  320. package/src/wms/csw-records-loader-with-parser.ts +28 -0
  321. package/src/wms/csw-records-loader.ts +52 -0
  322. package/src/wms/csw-source-loader.ts +330 -0
  323. package/src/wms/feature-pagination.ts +198 -0
  324. package/src/wms/gml-loader-types.ts +62 -0
  325. package/src/wms/gml-loader.ts +228 -0
  326. package/src/wms/index.ts +171 -0
  327. package/src/wms/lib/deprecated/create-image-service.ts.disabled +57 -0
  328. package/src/wms/lib/deprecated/create-image-source.ts +75 -0
  329. package/src/wms/lib/deprecated/image-source-compatibility.ts +28 -0
  330. package/src/wms/lib/deprecated/template-image-service.ts.disabled +68 -0
  331. package/src/wms/lib/parsers/csw/parse-csw-capabilities.ts +105 -0
  332. package/src/wms/lib/parsers/csw/parse-csw-domain.ts +47 -0
  333. package/src/wms/lib/parsers/csw/parse-csw-records.ts +94 -0
  334. package/src/wms/lib/parsers/csw/parse-exception-report.ts +33 -0
  335. package/src/wms/lib/parsers/gml/deep-strict-equal.ts +122 -0
  336. package/src/wms/lib/parsers/gml/parse-gml.ts +849 -0
  337. package/src/wms/lib/parsers/gml/rewind-geometry.ts +45 -0
  338. package/src/wms/lib/parsers/ogc-api/tile-matrix-limits.ts +107 -0
  339. package/src/wms/lib/parsers/ogc-api/tile-matrix-set.ts +167 -0
  340. package/src/wms/lib/parsers/wfs/parse-wfs-capabilities.ts +165 -0
  341. package/src/wms/lib/parsers/wfs/parse-wfs.ts +36 -0
  342. package/src/wms/lib/parsers/wms/parse-wms-capabilities.ts +427 -0
  343. package/src/wms/lib/parsers/wms/parse-wms-error.ts +24 -0
  344. package/src/wms/lib/parsers/wms/parse-wms-features.ts +41 -0
  345. package/src/wms/lib/parsers/wms/parse-wms-layer-description.ts +24 -0
  346. package/src/wms/lib/parsers/wmts/parse-wmts-capabilities.ts +281 -0
  347. package/src/wms/lib/parsers/xml/parse-xml-helpers.ts +67 -0
  348. package/src/wms/lib/parsers/xml/parse-xml-text.ts +11 -0
  349. package/src/wms/lib/tile-grid.ts +47 -0
  350. package/src/wms/managed-vector-source.ts +384 -0
  351. package/src/wms/ogc-api-coverages-source-loader.ts +109 -0
  352. package/src/wms/ogc-api-edr-source-loader.ts +127 -0
  353. package/src/wms/ogc-api-source-loader.ts +742 -0
  354. package/src/wms/service-capabilities.ts +147 -0
  355. package/src/wms/service-runtime.ts +225 -0
  356. package/src/wms/unbundled.ts +24 -0
  357. package/src/wms/wcs-source-loader.ts +260 -0
  358. package/src/wms/wfs-capabilities-loader-with-parser.ts +30 -0
  359. package/src/wms/wfs-capabilities-loader.ts +57 -0
  360. package/src/wms/wfs-source-loader.ts +987 -0
  361. package/src/wms/wip/data-source.ts +64 -0
  362. package/src/wms/wip/lib/wcs/parse-wcs-capabilities.ts +91 -0
  363. package/src/wms/wip/lib/wmts/parse-wmts-capabilities.ts +171 -0
  364. package/src/wms/wip/lib/wmts/parse-wmts.ts +39 -0
  365. package/src/wms/wip/services/wmts-service.ts.disabled +348 -0
  366. package/src/wms/wip/wcs-capabilities-loader-with-parser.ts +29 -0
  367. package/src/wms/wip/wcs-capabilities-loader.ts +50 -0
  368. package/src/wms/wip/wms-feature-info-loader-with-parser.ts +25 -0
  369. package/src/wms/wip/wms-feature-info-loader.ts +28 -0
  370. package/src/wms/wip/wms-layer-description-loader-with-parser.ts +25 -0
  371. package/src/wms/wip/wms-layer-description-loader.md.disabled.md +47 -0
  372. package/src/wms/wip/wms-layer-description-loader.ts +28 -0
  373. package/src/wms/wip/wmts-capabilities-loader-with-parser.ts +30 -0
  374. package/src/wms/wip/wmts-capabilities-loader.ts +52 -0
  375. package/src/wms/wms-capabilities-loader-with-parser.ts +45 -0
  376. package/src/wms/wms-capabilities-loader.ts +68 -0
  377. package/src/wms/wms-error-loader-with-parser.ts +44 -0
  378. package/src/wms/wms-error-loader.ts +56 -0
  379. package/src/wms/wms-format.ts +52 -0
  380. package/src/wms/wms-source-loader.ts +686 -0
  381. package/src/wms/wmts-capabilities-loader-with-parser.ts +17 -0
  382. package/src/wms/wmts-capabilities-loader.ts +30 -0
  383. package/src/wms/wmts-source-loader.ts +649 -0
@@ -0,0 +1,384 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Feature, GeoJSONTable, Geometry} from '@loaders.gl/core/schema';
6
+ import type {
7
+ GetFeaturesParameters,
8
+ VectorSource,
9
+ VectorSourceData,
10
+ VectorSourceMetadata
11
+ } from '@loaders.gl/core/loader-utils';
12
+ import {convertFeaturesToWKBArrowTable} from '@loaders.gl/arrow-geometry/feature-collection-to-arrow';
13
+ import {convertGeojsonToBinaryFeatureCollection} from '@loaders.gl/arrow-geometry/legacy-binary';
14
+ import {areServiceCRSEquivalent, normalizeServiceCRS} from './crs-utils';
15
+
16
+ /** Closed extent in canonical XY order. */
17
+ type Extent = [number, number, number, number];
18
+ /** Parameters defining an independently cached layer and coordinate system. */
19
+ type ScopeParameters = Pick<GetFeaturesParameters, 'layers' | 'crs' | 'requestCrs'>;
20
+ /** One verified complete response and the area it covers. */
21
+ type CachedExtent = {
22
+ /** Layer and CRS scope. */ scope: string;
23
+ /** Complete request bounds. */ extent: Extent;
24
+ /** Features owned by this cache entry. */ features: Feature[];
25
+ /** Monotonic response-completion order for newest-ID selection. */ revision: number;
26
+ };
27
+ /** A service response carrying its completion order. */
28
+ type ExtentResponse = {
29
+ /** Decoded service table. */ table: GeoJSONTable;
30
+ /** Monotonic completion order. */ revision: number;
31
+ };
32
+ /** One shared request with independently cancelable consumers. */
33
+ type PendingExtent = {
34
+ /** Fetch cancellation controller. */ controller: AbortController;
35
+ /** Shared result. */ promise: Promise<ExtentResponse>;
36
+ /** Number of callers still waiting. */ consumers: number;
37
+ };
38
+
39
+ /** Configuration for bounded, completeness-aware extent loading. */
40
+ export type ManagedVectorSourceOptions = {
41
+ /** Maximum retained complete extents, in completion order. Defaults to 32. */
42
+ maxCachedExtents?: number;
43
+ /** Stable identifier for deduplication. Defaults to feature.id; absent IDs are not deduplicated. */
44
+ getFeatureId?: (feature: Feature) => string | number | undefined;
45
+ /**
46
+ * Certifies that a response contains every matching feature for its request.
47
+ * By default only a numeric numberMatched/totalFeatures count equal to the row count,
48
+ * with no next link, certifies completeness. Unknown or truncated pages are never cached.
49
+ */
50
+ isComplete?: (table: GeoJSONTable, parameters: GetFeaturesParameters) => boolean;
51
+ };
52
+
53
+ /**
54
+ * Wraps a GeoJSON-capable source with managed coverage, request sharing and stable-ID deduplication.
55
+ *
56
+ * Coverage reuse requires explicit, equivalent request and output CRSs. Other requests pass
57
+ * through unchanged. Coordinates remain XY; no reprojection is performed.
58
+ * Pagination is delegated to the underlying source.
59
+ * Treat returned feature objects as immutable. Invalidate after changing service data or options.
60
+ */
61
+ export class ManagedVectorSource implements VectorSource {
62
+ /** Underlying source, also accessible for protocol-specific operations. */
63
+ readonly source: VectorSource;
64
+ /** Fixed cache policy. */
65
+ private readonly options: ManagedVectorSourceOptions;
66
+ /** Complete extents ordered by completion, bounded by the cache policy. */
67
+ private readonly cachedExtents: CachedExtent[] = [];
68
+ /** Identical pending requests are shared within one layer/CRS scope. */
69
+ private readonly pendingExtents = new Map<string, PendingExtent>();
70
+ /** Prevents requests started before invalidation from repopulating the cache. */
71
+ private generation = 0;
72
+ /** Orders completed responses independently of request scheduling. */
73
+ private responseRevision = 0;
74
+
75
+ /** Creates an empty extent cache around a source supporting format: 'geojson'. */
76
+ constructor(source: VectorSource, options: ManagedVectorSourceOptions = {}) {
77
+ const maximum = options.maxCachedExtents ?? 32;
78
+ if (!Number.isInteger(maximum) || maximum < 1)
79
+ throw new Error('maxCachedExtents must be a positive integer');
80
+ this.source = source;
81
+ this.options = {...options, maxCachedExtents: maximum};
82
+ }
83
+
84
+ /** Delegates schema discovery to the underlying source. */
85
+ getSchema(): ReturnType<VectorSource['getSchema']> {
86
+ return this.source.getSchema();
87
+ }
88
+
89
+ /** Delegates metadata discovery to the underlying source. */
90
+ getMetadata(options: {formatSpecificMetadata?: boolean} = {}): Promise<VectorSourceMetadata> {
91
+ return this.source.getMetadata(options);
92
+ }
93
+
94
+ /**
95
+ * Loads only uncovered rectangles, then returns bounding-box candidates for the requested extent.
96
+ * Failed, incomplete or aborted requests do not establish coverage and can be retried.
97
+ * One caller's cancellation leaves a shared request alive for its other callers.
98
+ * Returns GeoJSON by default, or the requested Arrow/binary encoding.
99
+ */
100
+ async getFeatures(parameters: GetFeaturesParameters): Promise<VectorSourceData> {
101
+ throwIfAborted(parameters.signal);
102
+ const extent = getExtent(parameters.boundingBox);
103
+ if (
104
+ !parameters.crs ||
105
+ !parameters.requestCrs ||
106
+ !areServiceCRSEquivalent(parameters.crs, parameters.requestCrs) ||
107
+ extent[0] === extent[2] ||
108
+ extent[1] === extent[3]
109
+ )
110
+ return this.source.getFeatures(parameters);
111
+ const scope = getScope(parameters);
112
+ const generation = this.generation;
113
+ let uncovered = [extent];
114
+ const existingEntries = this.cachedExtents.filter(entry => entry.scope === scope);
115
+ for (const entry of existingEntries) {
116
+ uncovered = uncovered.flatMap(bounds => subtractExtent(bounds, entry.extent));
117
+ }
118
+ const responses = await Promise.all(
119
+ uncovered.map(bounds => this.loadExtent(scope, bounds, parameters))
120
+ );
121
+ throwIfAborted(parameters.signal);
122
+ if (generation !== this.generation)
123
+ throw new DOMException('Vector cache invalidated', 'AbortError');
124
+ // Retain the snapshot for this query even if concurrent loads evict its entries.
125
+ const features = mergeFeatures(
126
+ [
127
+ ...existingEntries,
128
+ ...responses.map(response => ({
129
+ features: response.table.features,
130
+ revision: response.revision
131
+ }))
132
+ ]
133
+ .sort((first, second) => first.revision - second.revision)
134
+ .map(entry => entry.features),
135
+ this.options.getFeatureId
136
+ ).filter(feature => feature.geometry && intersectsGeometryBounds(feature.geometry, extent));
137
+ switch (parameters.format || 'geojson') {
138
+ case 'arrow':
139
+ return convertFeaturesToWKBArrowTable(features, {
140
+ encodingPreference: parameters.geoarrow?.encodingPreference
141
+ });
142
+ case 'binary':
143
+ return convertGeojsonToBinaryFeatureCollection(features);
144
+ default:
145
+ return {shape: 'geojson-table', type: 'FeatureCollection', features};
146
+ }
147
+ }
148
+
149
+ /** Returns copies of verified loaded extents for a layer/CRS scope, in completion order. */
150
+ getLoadedExtents(parameters: ScopeParameters): GetFeaturesParameters['boundingBox'][] {
151
+ const scope = getScope(parameters);
152
+ return this.cachedExtents
153
+ .filter(entry => entry.scope === scope)
154
+ .map(entry => getBoundingBox(entry.extent));
155
+ }
156
+
157
+ /** Evicts whole cached requests intersecting this area and cancels pending loads. */
158
+ invalidateExtent(parameters: ScopeParameters & Pick<GetFeaturesParameters, 'boundingBox'>): void {
159
+ const extent = getExtent(parameters.boundingBox);
160
+ const scope = getScope(parameters);
161
+ this.cancelPending();
162
+ for (let index = this.cachedExtents.length - 1; index >= 0; index--) {
163
+ const entry = this.cachedExtents[index];
164
+ if (entry.scope === scope && intersectsBounds(entry.extent, extent))
165
+ this.cachedExtents.splice(index, 1);
166
+ }
167
+ }
168
+
169
+ /** Clears all loaded coverage and aborts pending requests; the source can be reused afterwards. */
170
+ clear(): void {
171
+ this.cancelPending();
172
+ this.cachedExtents.length = 0;
173
+ }
174
+
175
+ /** Cancels all pending work and rejects late responses even when a source ignores cancellation. */
176
+ private cancelPending(): void {
177
+ this.generation++;
178
+ for (const pending of this.pendingExtents.values()) pending.controller.abort();
179
+ this.pendingExtents.clear();
180
+ }
181
+
182
+ /** Loads or joins one uncovered rectangle and commits only verified complete responses. */
183
+ private async loadExtent(
184
+ scope: string,
185
+ extent: Extent,
186
+ parameters: GetFeaturesParameters
187
+ ): Promise<ExtentResponse> {
188
+ const key = JSON.stringify([scope, extent]);
189
+ let pending = this.pendingExtents.get(key);
190
+ if (!pending) {
191
+ const controller = new AbortController();
192
+ const generation = this.generation;
193
+ const request = {
194
+ ...parameters,
195
+ layers: Array.isArray(parameters.layers) ? [...parameters.layers] : parameters.layers,
196
+ boundingBox: getBoundingBox(extent),
197
+ format: 'geojson' as const,
198
+ signal: controller.signal
199
+ };
200
+ const shared: PendingExtent = {
201
+ controller,
202
+ consumers: 0,
203
+ promise: Promise.resolve()
204
+ .then(async () => {
205
+ throwIfAborted(controller.signal);
206
+ const table = await this.source.getFeatures(request);
207
+ throwIfAborted(controller.signal);
208
+ const revision = ++this.responseRevision;
209
+ if (table.shape !== 'geojson-table')
210
+ throw new Error('ManagedVectorSource requires GeoJSON responses');
211
+ if (
212
+ generation === this.generation &&
213
+ (this.options.isComplete || isCompleteResponse)(table, request)
214
+ ) {
215
+ this.cachedExtents.push({scope, extent, features: table.features, revision});
216
+ while (this.cachedExtents.length > this.options.maxCachedExtents!)
217
+ this.cachedExtents.shift();
218
+ }
219
+ return {table, revision};
220
+ })
221
+ .finally(() => {
222
+ if (this.pendingExtents.get(key) === shared) this.pendingExtents.delete(key);
223
+ })
224
+ };
225
+ pending = shared;
226
+ this.pendingExtents.set(key, shared);
227
+ }
228
+ pending.consumers++;
229
+ try {
230
+ return await waitForResponse(pending.promise, parameters.signal, pending.controller.signal);
231
+ } finally {
232
+ pending.consumers--;
233
+ if (!pending.consumers && this.pendingExtents.get(key) === pending) {
234
+ this.pendingExtents.delete(key);
235
+ pending.controller.abort();
236
+ }
237
+ }
238
+ }
239
+ }
240
+
241
+ /** Validates ordered, finite bounds and converts the public shape to an extent. */
242
+ function getExtent(bounds: GetFeaturesParameters['boundingBox']): Extent {
243
+ const extent: Extent = [bounds[0][0], bounds[0][1], bounds[1][0], bounds[1][1]];
244
+ if (!extent.every(Number.isFinite) || extent[0] > extent[2] || extent[1] > extent[3])
245
+ throw new Error('Bounding box must contain finite, ordered XY bounds');
246
+ return extent;
247
+ }
248
+
249
+ /** Produces fresh coordinate arrays so callers cannot mutate cached coverage. */
250
+ function getBoundingBox(extent: Extent): GetFeaturesParameters['boundingBox'] {
251
+ return [
252
+ [extent[0], extent[1]],
253
+ [extent[2], extent[3]]
254
+ ];
255
+ }
256
+
257
+ /** Keys ordered layer selections and normalized coordinate systems independently of output encoding. */
258
+ function getScope(parameters: ScopeParameters): string {
259
+ return JSON.stringify([
260
+ Array.isArray(parameters.layers) ? parameters.layers : [parameters.layers],
261
+ normalizeServiceCRS(parameters.requestCrs),
262
+ normalizeServiceCRS(parameters.crs)
263
+ ]);
264
+ }
265
+
266
+ /** Tests closed bounding-box intersection. */
267
+ function intersectsBounds(first: Extent, second: Extent): boolean {
268
+ return (
269
+ first[0] <= second[2] && first[2] >= second[0] && first[1] <= second[3] && first[3] >= second[1]
270
+ );
271
+ }
272
+
273
+ /** Subtracts positive-area coverage into at most four disjoint rectangles. */
274
+ function subtractExtent(request: Extent, covered: Extent): Extent[] {
275
+ const minimumX = Math.max(request[0], covered[0]);
276
+ const minimumY = Math.max(request[1], covered[1]);
277
+ const maximumX = Math.min(request[2], covered[2]);
278
+ const maximumY = Math.min(request[3], covered[3]);
279
+ if (minimumX >= maximumX || minimumY >= maximumY) return [request];
280
+ const rectangles: Extent[] = [];
281
+ if (request[0] < minimumX) rectangles.push([request[0], request[1], minimumX, request[3]]);
282
+ if (maximumX < request[2]) rectangles.push([maximumX, request[1], request[2], request[3]]);
283
+ if (request[1] < minimumY) rectangles.push([minimumX, request[1], maximumX, minimumY]);
284
+ if (maximumY < request[3]) rectangles.push([minimumX, maximumY, maximumX, request[3]]);
285
+ return rectangles;
286
+ }
287
+
288
+ /** Requires explicit matching counts and refuses an advertised next page. */
289
+ function isCompleteResponse(table: GeoJSONTable): boolean {
290
+ const metadata = table as GeoJSONTable & {
291
+ numberMatched?: unknown;
292
+ totalFeatures?: unknown;
293
+ links?: {rel?: string}[];
294
+ next?: string;
295
+ };
296
+ const count = metadata.numberMatched ?? metadata.totalFeatures;
297
+ return (
298
+ typeof count === 'number' &&
299
+ Number.isInteger(count) &&
300
+ count === table.features.length &&
301
+ !metadata.next &&
302
+ !metadata.links?.some(link => link.rel === 'next')
303
+ );
304
+ }
305
+
306
+ /** Keeps the newest feature for each typed ID, retaining all unidentified features. */
307
+ function mergeFeatures(
308
+ groups: Feature[][],
309
+ getFeatureId: ManagedVectorSourceOptions['getFeatureId'] = feature => feature.id
310
+ ): Feature[] {
311
+ const features: Feature[] = [];
312
+ const rowsById = new Map<string | number, number>();
313
+ for (const group of groups)
314
+ for (const feature of group) {
315
+ const identifier = getFeatureId(feature);
316
+ const row = identifier === undefined ? undefined : rowsById.get(identifier);
317
+ if (row !== undefined) features[row] = feature;
318
+ else {
319
+ if (identifier !== undefined) rowsById.set(identifier, features.length);
320
+ features.push(feature);
321
+ }
322
+ }
323
+ return features;
324
+ }
325
+
326
+ /** Computes geometry bounds in output XY; null and empty geometries cannot match. */
327
+ function intersectsGeometryBounds(geometry: Geometry, extent: Extent): boolean {
328
+ const bounds: Extent = [Infinity, Infinity, -Infinity, -Infinity];
329
+ /** Visits coordinate nesting without depending on an Arrow runtime. */
330
+ const visitCoordinates = (
331
+ coordinates: number[] | number[][] | number[][][] | number[][][][]
332
+ ): void => {
333
+ if (typeof coordinates[0] === 'number') {
334
+ const position = coordinates as number[];
335
+ if (!Number.isFinite(position[0]) || !Number.isFinite(position[1])) return;
336
+ bounds[0] = Math.min(bounds[0], position[0]);
337
+ bounds[1] = Math.min(bounds[1], position[1]);
338
+ bounds[2] = Math.max(bounds[2], position[0]);
339
+ bounds[3] = Math.max(bounds[3], position[1]);
340
+ } else for (const child of coordinates as number[][][]) visitCoordinates(child);
341
+ };
342
+ /** Includes every member of a collection in its overall bounds. */
343
+ const visitGeometry = (child: Geometry): void => {
344
+ if (child.type === 'GeometryCollection') child.geometries.forEach(visitGeometry);
345
+ else visitCoordinates(child.coordinates);
346
+ };
347
+ visitGeometry(geometry);
348
+ return bounds.every(Number.isFinite) && intersectsBounds(bounds, extent);
349
+ }
350
+
351
+ /** Throws the standard cancellation error for an already aborted request. */
352
+ function throwIfAborted(signal?: AbortSignal): void {
353
+ if (signal?.aborted) throw new DOMException('Vector request aborted', 'AbortError');
354
+ }
355
+
356
+ /** Cancels a caller's wait independently and always removes abort listeners. */
357
+ function waitForResponse<T>(
358
+ promise: Promise<T>,
359
+ ...signals: (AbortSignal | undefined)[]
360
+ ): Promise<T> {
361
+ return new Promise((resolve, reject) => {
362
+ /** Releases every listener when the wait settles. */
363
+ const cleanup = (): void => {
364
+ for (const signal of signals) signal?.removeEventListener('abort', abort);
365
+ };
366
+ /** Rejects on caller cancellation or cache invalidation. */
367
+ const abort = (): void => {
368
+ cleanup();
369
+ reject(new DOMException('Vector request aborted', 'AbortError'));
370
+ };
371
+ for (const signal of signals) signal?.addEventListener('abort', abort, {once: true});
372
+ if (signals.some(signal => signal?.aborted)) abort();
373
+ promise.then(
374
+ value => {
375
+ cleanup();
376
+ resolve(value);
377
+ },
378
+ error => {
379
+ cleanup();
380
+ reject(error);
381
+ }
382
+ );
383
+ });
384
+ }
@@ -0,0 +1,109 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {CoreAPI, DataSourceOptions, SourceLoader} from '@loaders.gl/core/loader-utils';
6
+ import {DataSource} from '@loaders.gl/core/loader-utils';
7
+ import type {OGCAPILandingPage, OGCAPICollection} from './ogc-api-source-loader';
8
+
9
+ /** Options for an OGC API Coverages source. */
10
+ export type OGCAPICoveragesSourceOptions = DataSourceOptions & {
11
+ /** Coverage request defaults. */
12
+ 'ogc-api-coverages'?: {collectionId?: string; parameters?: Record<string, string>};
13
+ };
14
+
15
+ /** Parameters for a minimal OGC API Coverages query. */
16
+ export type OGCAPICoveragesQueryParameters = {
17
+ /** Coverage collection identifier. */
18
+ collectionId?: string;
19
+ /** Bounding box in the requested CRS. */
20
+ bbox?: [number, number, number, number];
21
+ /** RFC 3339 instant or interval. */
22
+ datetime?: string;
23
+ /** Coverage dimension subsets, for example `Lat(40,45)`. */
24
+ subset?: string[];
25
+ /** Requested output media type. */
26
+ format?: string;
27
+ /** Additional query parameters. */
28
+ parameters?: Record<string, string | number | boolean>;
29
+ /** Abort signal for cancellation. */
30
+ signal?: AbortSignal;
31
+ };
32
+
33
+ /** Minimal OGC API Coverages source for discovery and coverage retrieval. */
34
+ export class OGCAPICoveragesSource extends DataSource<string, OGCAPICoveragesSourceOptions> {
35
+ /** Creates an OGC API Coverages source. */
36
+ constructor(url: string, options: OGCAPICoveragesSourceOptions = {}, coreApi?: CoreAPI) {
37
+ super(url.replace(/\/$/, ''), options, OGCAPICoveragesSourceLoader.defaultOptions, coreApi);
38
+ }
39
+
40
+ /** Returns the OGC API landing page. */
41
+ async getLandingPage(): Promise<OGCAPILandingPage> {
42
+ return (await this.fetchJSON(this.url)) as OGCAPILandingPage;
43
+ }
44
+
45
+ /** Lists collections advertised by the service. */
46
+ async getCollections(): Promise<OGCAPICollection[]> {
47
+ const response = (await this.fetchJSON(`${this.url}/collections`)) as {
48
+ collections?: OGCAPICollection[];
49
+ };
50
+ return response.collections || [];
51
+ }
52
+
53
+ /** Fetches a coverage representation from a collection. */
54
+ async getCoverage(parameters: OGCAPICoveragesQueryParameters = {}): Promise<unknown> {
55
+ const collectionId = parameters.collectionId || this.options['ogc-api-coverages']?.collectionId;
56
+ if (!collectionId) throw new Error('OGC API Coverages request requires a collectionId');
57
+ const url = new URL(`${this.url}/collections/${encodeURIComponent(collectionId)}/coverage`);
58
+ const queryParameters = {
59
+ ...this.options['ogc-api-coverages']?.parameters,
60
+ ...parameters.parameters,
61
+ bbox: parameters.bbox?.join(','),
62
+ datetime: parameters.datetime,
63
+ subset: parameters.subset,
64
+ f: parameters.format
65
+ };
66
+ for (const [key, value] of Object.entries(queryParameters)) {
67
+ if (Array.isArray(value)) {
68
+ for (const item of value) url.searchParams.append(key, item);
69
+ } else if (value !== undefined) {
70
+ url.searchParams.set(key, String(value));
71
+ }
72
+ }
73
+ const response = await this.fetch(url.toString(), {
74
+ signal: parameters.signal,
75
+ headers: {Accept: parameters.format || 'application/json'}
76
+ });
77
+ if (!response.ok) throw new Error(`OGC API Coverages request failed: ${response.status}`);
78
+ const contentType = response.headers.get('content-type') || parameters.format || '';
79
+ return /json/i.test(contentType) ? response.json() : response.arrayBuffer();
80
+ }
81
+
82
+ /** Fetches and decodes a JSON service response. */
83
+ private async fetchJSON(url: string): Promise<unknown> {
84
+ const response = await this.fetch(url, {headers: {Accept: 'application/json'}});
85
+ if (!response.ok) throw new Error(`OGC API Coverages request failed: ${response.status}`);
86
+ return response.json();
87
+ }
88
+ }
89
+
90
+ /** Source loader for minimal OGC API Coverages support. */
91
+ export const OGCAPICoveragesSourceLoader = {
92
+ dataType: null as unknown as OGCAPICoveragesSource,
93
+ batchType: null as never,
94
+ name: 'OGC API Coverages',
95
+ id: 'ogc-api-coverages',
96
+ module: 'ogc',
97
+ version: '0.0.0',
98
+ extensions: [],
99
+ mimeTypes: ['application/json', 'image/tiff', 'application/octet-stream'],
100
+ type: 'ogc-api-coverages',
101
+ fromUrl: true,
102
+ fromBlob: false,
103
+ options: {'ogc-api-coverages': {}},
104
+ defaultOptions: {'ogc-api-coverages': {}},
105
+ testURL: (url: string): boolean =>
106
+ /(?:\/coverage(?:s)?(?:\/|$)|ogc[/-]?api[/-]?coverages)/i.test(url),
107
+ createDataSource: (url: string, options: OGCAPICoveragesSourceOptions = {}, coreApi?: CoreAPI) =>
108
+ new OGCAPICoveragesSource(url, options, coreApi)
109
+ } as const satisfies SourceLoader<OGCAPICoveragesSource>;
@@ -0,0 +1,127 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {CoreAPI, DataSourceOptions, SourceLoader} from '@loaders.gl/core/loader-utils';
6
+ import {DataSource} from '@loaders.gl/core/loader-utils';
7
+ import type {OGCAPILandingPage, OGCAPICollection} from './ogc-api-source-loader';
8
+
9
+ /** Options for an OGC API EDR source. */
10
+ export type OGCAPIEDRSourceOptions = DataSourceOptions & {
11
+ /** EDR request defaults. */
12
+ 'ogc-api-edr'?: {collectionId?: string; parameters?: Record<string, string>};
13
+ };
14
+
15
+ /** Parameters shared by OGC API EDR query endpoints. */
16
+ export type OGCAPIEDRQueryParameters = {
17
+ /** Collection identifier. */
18
+ collectionId?: string;
19
+ /** EDR query path, such as `position`, `area`, or `cube`. */
20
+ queryType: 'position' | 'radius' | 'area' | 'cube' | 'trajectory' | 'corridor';
21
+ /** Position or geometry encoded as required by the EDR server. */
22
+ coords?: string;
23
+ /** Bounding box in source coordinates. */
24
+ bbox?: [number, number, number, number];
25
+ /** RFC 3339 time or interval. */
26
+ datetime?: string;
27
+ /** Requested parameter identifiers. */
28
+ parameterName?: string | string[];
29
+ /** Vertical range or level. */
30
+ z?: string;
31
+ /** Requested CRS. */
32
+ crs?: string;
33
+ /** Response format. */
34
+ format?: string;
35
+ /** Additional query parameters. */
36
+ parameters?: Record<string, string | number | boolean>;
37
+ /** Abort signal for cancellation. */
38
+ signal?: AbortSignal;
39
+ };
40
+
41
+ /** Minimal OGC API EDR source for discovery and spatiotemporal queries. */
42
+ export class OGCAPIEDRSource extends DataSource<string, OGCAPIEDRSourceOptions> {
43
+ /** Creates an EDR source. */
44
+ constructor(url: string, options: OGCAPIEDRSourceOptions = {}, coreApi?: CoreAPI) {
45
+ super(url.replace(/\/$/, ''), options, OGCAPIEDRSourceLoader.defaultOptions, coreApi);
46
+ }
47
+
48
+ /** Returns the EDR landing page. */
49
+ async getLandingPage(): Promise<OGCAPILandingPage> {
50
+ return (await this.fetchJSON(this.url)) as OGCAPILandingPage;
51
+ }
52
+
53
+ /** Lists collections advertised by the EDR service. */
54
+ async getCollections(): Promise<OGCAPICollection[]> {
55
+ const response = (await this.fetchJSON(`${this.url}/collections`)) as {
56
+ collections?: OGCAPICollection[];
57
+ };
58
+ return response.collections || [];
59
+ }
60
+
61
+ /** Executes a focused EDR spatiotemporal query and returns the advertised representation. */
62
+ async query(parameters: OGCAPIEDRQueryParameters): Promise<unknown> {
63
+ const collectionId = parameters.collectionId || this.options['ogc-api-edr']?.collectionId;
64
+ if (!collectionId) throw new Error('OGC API EDR query requires a collectionId');
65
+ const url = new URL(
66
+ `${this.url}/collections/${encodeURIComponent(collectionId)}/${parameters.queryType}`
67
+ );
68
+ const queryParameters = {
69
+ ...this.options['ogc-api-edr']?.parameters,
70
+ ...parameters.parameters,
71
+ coords: parameters.coords,
72
+ bbox: parameters.bbox?.join(','),
73
+ datetime: parameters.datetime,
74
+ 'parameter-name': Array.isArray(parameters.parameterName)
75
+ ? parameters.parameterName.join(',')
76
+ : parameters.parameterName,
77
+ z: parameters.z,
78
+ crs: parameters.crs,
79
+ f: parameters.format
80
+ };
81
+ for (const [key, value] of Object.entries(queryParameters)) {
82
+ if (value !== undefined) url.searchParams.set(key, String(value));
83
+ }
84
+ const response = await this.fetch(url.toString(), {
85
+ signal: parameters.signal,
86
+ headers: {Accept: parameters.format || 'application/geo+json, application/json;q=0.9'}
87
+ });
88
+ if (!response.ok) throw new Error(`OGC API EDR request failed: ${response.status}`);
89
+ return readResponse(response, parameters.format);
90
+ }
91
+
92
+ /** Fetches and decodes a JSON service response. */
93
+ private async fetchJSON(url: string): Promise<unknown> {
94
+ const response = await this.fetch(url, {headers: {Accept: 'application/json'}});
95
+ if (!response.ok) throw new Error(`OGC API EDR request failed: ${response.status}`);
96
+ return response.json();
97
+ }
98
+ }
99
+
100
+ /** Source loader for OGC API EDR services. */
101
+ export const OGCAPIEDRSourceLoader = {
102
+ dataType: null as unknown as OGCAPIEDRSource,
103
+ batchType: null as never,
104
+ name: 'OGC API EDR',
105
+ id: 'ogc-api-edr',
106
+ module: 'ogc',
107
+ version: '0.0.0',
108
+ extensions: [],
109
+ mimeTypes: ['application/json', 'application/geo+json'],
110
+ type: 'ogc-api-edr',
111
+ fromUrl: true,
112
+ fromBlob: false,
113
+ options: {'ogc-api-edr': {}},
114
+ defaultOptions: {'ogc-api-edr': {}},
115
+ testURL: (url: string): boolean =>
116
+ /(?:\/edr(?:\/|$)|ogc[/-]?api[/-]?edr|\/collections\/[^/]+\/(?:position|radius|area|cube|trajectory|corridor|locations)(?:\/|$))/i.test(
117
+ url
118
+ ),
119
+ createDataSource: (url: string, options: OGCAPIEDRSourceOptions = {}, coreApi?: CoreAPI) =>
120
+ new OGCAPIEDRSource(url, options, coreApi)
121
+ } as const satisfies SourceLoader<OGCAPIEDRSource>;
122
+
123
+ /** Reads JSON or binary content according to the response headers. */
124
+ async function readResponse(response: Response, format?: string): Promise<unknown> {
125
+ const contentType = response.headers.get('content-type') || format || '';
126
+ return /json/i.test(contentType) ? response.json() : response.arrayBuffer();
127
+ }