-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathguidance.html
2528 lines (2497 loc) · 370 KB
/
guidance.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
<meta charset="utf-8">
<meta name="generator" content="quarto-1.3.433">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Geoconnex Structured Metadata Guidance</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: min(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
vertical-align: middle;
}
/* CSS for syntax highlighting */
pre > code.sourceCode { white-space: pre; position: relative; }
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
pre > code.sourceCode > span:empty { height: 1.2em; }
.sourceCode { overflow: visible; }
code.sourceCode > span { color: inherit; text-decoration: inherit; }
div.sourceCode { margin: 1em 0; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
pre > code.sourceCode { white-space: pre-wrap; }
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
}
pre.numberSource code
{ counter-reset: source-line 0; }
pre.numberSource code > span
{ position: relative; left: -4em; counter-increment: source-line; }
pre.numberSource code > span > a:first-child::before
{ content: counter(source-line);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
}
pre.numberSource { margin-left: 3em; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
}
</style>
<script src="index_files/libs/clipboard/clipboard.min.js"></script>
<script src="index_files/libs/quarto-html/quarto.js"></script>
<script src="index_files/libs/quarto-html/popper.min.js"></script>
<script src="index_files/libs/quarto-html/tippy.umd.min.js"></script>
<script src="index_files/libs/quarto-html/anchor.min.js"></script>
<link href="index_files/libs/quarto-html/tippy.css" rel="stylesheet">
<link href="index_files/libs/quarto-html/quarto-syntax-highlighting.css" rel="stylesheet" id="quarto-text-highlighting-styles">
<script src="index_files/libs/bootstrap/bootstrap.min.js"></script>
<link href="index_files/libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
<link href="index_files/libs/bootstrap/bootstrap.min.css" rel="stylesheet" id="quarto-bootstrap" data-mode="light">
<style>
.quarto-title-block .quarto-title-banner {
background: #181868;
}
</style>
</head>
<body>
<header id="title-block-header" class="quarto-title-block default toc-left page-columns page-full">
<div class="quarto-title-banner page-columns page-full">
<div class="quarto-title column-body">
<div class="quarto-title-block"><div><h1 class="title">Geoconnex Structured Metadata Guidance</h1><button type="button" class="btn code-tools-button" id="quarto-code-tools-source"><i class="bi"></i> Code</button></div></div>
</div>
</div>
<div class="quarto-title-meta">
</div>
</header><div id="quarto-content" class="page-columns page-rows-contents page-layout-article toc-left">
<div id="quarto-sidebar-toc-left" class="sidebar toc-left">
<nav id="TOC" role="doc-toc" class="toc-active" data-toc-expanded="6">
<h2 id="toc-title">Table of Contents</h2>
<ul>
<li><a href="#sec-introduction" id="toc-sec-introduction" class="nav-link active" data-scroll-target="#sec-introduction"><span class="header-section-number">1</span> Introduction</a>
<ul>
<li><a href="#sec-infomodel" id="toc-sec-infomodel" class="nav-link" data-scroll-target="#sec-infomodel"><span class="header-section-number">1.1</span> Basic Information Model</a></li>
<li><a href="#sec-primer" id="toc-sec-primer" class="nav-link" data-scroll-target="#sec-primer"><span class="header-section-number">1.2</span> JSON-LD Primer</a></li>
<li><a href="#sec-jsonldelem" id="toc-sec-jsonldelem" class="nav-link" data-scroll-target="#sec-jsonldelem"><span class="header-section-number">1.3</span> Geoconnex JSON-LD elements</a>
<ul>
<li><a href="#sec-context" id="toc-sec-context" class="nav-link" data-scroll-target="#sec-context"><span class="header-section-number">1.3.1</span> Context</a></li>
<li><a href="#sec-ref" id="toc-sec-ref" class="nav-link" data-scroll-target="#sec-ref"><span class="header-section-number">1.3.2</span> Reference Features</a></li>
</ul></li>
</ul></li>
<li><a href="#sec-step-by-step" id="toc-sec-step-by-step" class="nav-link" data-scroll-target="#sec-step-by-step"><span class="header-section-number">2</span> Building Geoconnex Web Resources, Step-by-Step</a>
<ul>
<li><a href="#location-or-dataset-oriented" id="toc-location-or-dataset-oriented" class="nav-link" data-scroll-target="#location-or-dataset-oriented"><span class="header-section-number">2.1</span> Location or Dataset oriented?</a>
<ul>
<li><a href="#sec-loc" id="toc-sec-loc" class="nav-link" data-scroll-target="#sec-loc"><span class="header-section-number">2.1.1</span> Location-oriented</a>
<ul>
<li><a href="#json-ld" id="toc-json-ld" class="nav-link" data-scroll-target="#json-ld"><span class="header-section-number">2.1.1.1</span> JSON-LD</a>
<ul>
<li><a href="#sec-ident" id="toc-sec-ident" class="nav-link" data-scroll-target="#sec-ident"><span class="header-section-number">2.1.1.1.1</span> Identifiers and provenance</a></li>
<li><a href="#sec-spatial" id="toc-sec-spatial" class="nav-link" data-scroll-target="#sec-spatial"><span class="header-section-number">2.1.1.1.2</span> Spatial geometry and hydrologic references</a></li>
<li><a href="#sec-loc-data" id="toc-sec-loc-data" class="nav-link" data-scroll-target="#sec-loc-data"><span class="header-section-number">2.1.1.1.3</span> Datasets</a></li>
</ul></li>
</ul></li>
<li><a href="#sec-data" id="toc-sec-data" class="nav-link" data-scroll-target="#sec-data"><span class="header-section-number">2.1.2</span> Dataset-oriented</a>
<ul>
<li><a href="#json-ld-1" id="toc-json-ld-1" class="nav-link" data-scroll-target="#json-ld-1"><span class="header-section-number">2.1.2.1</span> JSON-LD</a>
<ul>
<li><a href="#identifiers-provenance-license-and-distribution." id="toc-identifiers-provenance-license-and-distribution." class="nav-link" data-scroll-target="#identifiers-provenance-license-and-distribution."><span class="header-section-number">2.1.2.1.1</span> Identifiers, provenance, license, and distribution.</a></li>
<li><a href="#variables-and-methods" id="toc-variables-and-methods" class="nav-link" data-scroll-target="#variables-and-methods"><span class="header-section-number">2.1.2.1.2</span> Variables and Methods</a></li>
<li><a href="#geoconnex-reference-feature-links-and-spatial-coverage" id="toc-geoconnex-reference-feature-links-and-spatial-coverage" class="nav-link" data-scroll-target="#geoconnex-reference-feature-links-and-spatial-coverage"><span class="header-section-number">2.1.2.1.3</span> Geoconnex Reference Feature Links and Spatial Coverage</a></li>
</ul></li>
</ul></li>
</ul></li>
<li><a href="#sec-complete-examples" id="toc-sec-complete-examples" class="nav-link" data-scroll-target="#sec-complete-examples"><span class="header-section-number">2.2</span> Complete Examples</a>
<ul>
<li><a href="#sec-loc-complete-example" id="toc-sec-loc-complete-example" class="nav-link" data-scroll-target="#sec-loc-complete-example"><span class="header-section-number">2.2.1</span> Location-oriented</a></li>
<li><a href="#sec-data-complete-example" id="toc-sec-data-complete-example" class="nav-link" data-scroll-target="#sec-data-complete-example"><span class="header-section-number">2.2.2</span> Dataset-oriented</a></li>
</ul></li>
<li><a href="#sec-appendices" id="toc-sec-appendices" class="nav-link" data-scroll-target="#sec-appendices"><span class="header-section-number">2.3</span> Appendices</a>
<ul>
<li><a href="#sec-codelists" id="toc-sec-codelists" class="nav-link" data-scroll-target="#sec-codelists"><span class="header-section-number">2.3.1</span> Appendix 1: Codelists</a>
<ul>
<li><a href="#sec-measurementTechnique" id="toc-sec-measurementTechnique" class="nav-link" data-scroll-target="#sec-measurementTechnique"><span class="header-section-number">2.3.1.1</span> measurementTechnique</a></li>
</ul></li>
</ul></li>
</ul></li>
</ul>
</nav>
</div>
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
</div>
<main class="content quarto-banner-title-block" id="quarto-document-content">
<div data-align="center">
<p><img src="images/geoconnex-logo.png" alt="Logo" width="600"></p>
</div>
<section id="sec-introduction" class="level1" data-number="1">
<h1 data-number="1"><span class="header-section-number">1</span> Introduction</h1>
<p>The Geoconnex project is about providing technical infrastructure and guidance to create an open, community-contribution model for a knowledge graph linking hydrologic features in the United States, published in accordance with <a href="https://www.w3.org/TR/sdw-bp/">Spatial Data on the Web best practices</a> as an implementation of <a href="https://github.com/opengeospatial/SELFIE/blob/master/docs/demo/internet_of_water.md">Internet of Water</a> principles. The development of geoconnex.us takes place on GitHub. See <a href="https://github.com/internetofwater/about.geoconnex.us">here</a> for the system of repositories.</p>
<p>Geoconnex will allow data users to answer questions like: “What datasets are available about the portions of <a href="https://geoconnex.us/ref/mainstems/29559" title="This is an HTTP identifier in the geoconnex system to unambiguously denote the Colorado River"><strong>Colorado River</strong></a> <em>upstream</em> of <a href="https://geoconnex.us/ref/dams/1080095" title="This an HTTP identifier in the Geoconnex system to unambiguously identify the Hoover Dam, in particular its location along the Colorado River"><strong>Hoover Dam</strong></a> <em>within</em> <strong>Nevada</strong> and <strong>Utah</strong> regarding <em>variables</em> <strong>discharge</strong> and <strong>total suspended solids</strong> with measurements taken at least <strong>daily</strong> with <em>coverage</em> <strong>between 2002 and 2007</strong>?” and be returned metadata for all relevant datasets from all participating organizations, including federal, state, private, and NGO organizations.</p>
<p>See <a href="https://geoconnex.us/demo" class="uri">https://geoconnex.us/demo</a> for a mockup of data discovery and access workflows that <code>https://geoconnex.us</code> aspires to enable.</p>
<p>Geoconnex rests on data providers publishing metadata to the system. Thus, Geoconnex involves the publication of Web Resources, which include structured, embedded metaadata that describe water datasets and the real-world environmental features (eg rivers, wells, dams, catchments) or the cataloging features (eg government jurisdiction areas, statiscal summary reporting areas) that they are relevant to. This document provides guidance, including general principles as well as specific templates, for data providers for how to structure this metadata using the JSON-LD format.</p>
<p><strong>Related materials, presentations, and publications</strong></p>
<p><a href="https://drive.google.com/file/d/1J0NKYOq3pGjQXr58FKO8sd7uHpGA8kNB/view?usp=sharing">National Hydrography Infrastructure and Geoconnex</a></p>
<p><a href="https://docs.google.com/presentation/d/1yuNpBbQPcmb_Nw8DXiuNTazAjIM8UF7o/edit?usp=sharing&ouid=102421334323378854304&rtpof=true&sd=true">New Mexico Water Data Initiative including geoconnex.us</a></p>
<p><a href="https://www.westernstateswater.org/wp-content/uploads/2020/06/CO_Roundable_IoW.pdf">Roundtable presentation including geoconnex.us</a></p>
<p><a href="https://github.com/opengeospatial/SELFIE">Second Environmental Linked Features Interoperability Experiment</a></p>
<p><a href="https://2020esipsummermeeting.sched.com/event/cIvv/structured-data-on-the-web-putting-best-practice-to-work">ESIP Sessions on Structured Data in the Web</a> <a href="https://docs.google.com/presentation/d/1LSXHz2_Y7hrkGZPC_sNoJWl8AIujI8AAWktl9amIR4E/edit#slide=id.g8250495469_1_30">slides</a></p>
<section id="sec-infomodel" class="level2" data-number="1.1">
<h2 data-number="1.1" class="anchored" data-anchor-id="sec-infomodel"><span class="header-section-number">1.1</span> Basic Information Model</h2>
<p>The model used to organize information in the Geoconnex system is shown in <a href="#fig-info-model">Figure 1</a>.</p>
<div id="fig-info-model" class="quarto-figure quarto-figure-center anchored">
<figure class="figure">
<p><img src="images/screenshot.png" class="img-fluid figure-img"></p>
<figcaption class="figure-caption">Figure 1: Basic information model for resources in geoconnex</figcaption>
</figure>
</div>
<ul>
<li><p><strong>Data providers</strong> refer to specific systems that publish water-related <strong>datasets</strong> on the web. Many times a provider will simply be the data dissemination arm of an organization, such as the <a href="https://data.usbr.gov">Reclamation Information Sharing Environment (RISE)</a> of the US Bureau of Reclamation. Some organizations may have multiple data providers, such as US Geological Survey, which administers the <a href="https://waterdata.usgs.gov">National Water Information System</a> as well as the <a href="https://cida.usgs.gov/ngwmn/">National Groundwater Monitoring Network</a>, among others. Some data providers are aggregators of other organizations’ data, such as the <a href="https://data.cuahsi.org">Hydrologic Information System</a> of CUAHSI.</p></li>
<li><p><strong>Datasets</strong> refer to specific collections of data that are published by data providers. In the context of Geoconnex, a single dataset generally refers to one that is collected from, or summarizable to, a specific spatial <strong>location</strong> on earth, as part of a specific activity. For example, a dataset would be the stage, discharge and water quality sensor data coming from a single stream gage, but not the collection of all stream gage readings from all stream gages operated by a given organization. A dataset could also be the time-series of a statistical summary of water use at the county level.</p></li>
<li><p><strong>Locations</strong> are specific locations on earth that datasets are collected from or about, such as stream gages, groundwater wells, and dams. In the case of data that is reported at a summary unit such as a state, county, or hydrologic unit code (HUC), these can also be considered Locations. Conceptually, multiple datasets from multiple providers can be about the same Location, as might occur when a USGS streamgage and a state DEQ water quality sampling site are both located at a specific bridge.</p></li>
<li><p><strong>Hydrologic features</strong> are elements of the water system that are related to locations. For example, a point may be on a river, which is within a watershed, and whose flow influences an aquifer. Each of these are distinct, identifiable features which many Locations are hydrologically related to, and which a user of a given dataset might also want to use.</p></li>
<li><p><strong>Cataloging features</strong> are areas on earth that commonly group datasets. They are a superset of summary features such as HUCs, counties and states. For example, a state-level dataset summarizing average annual surface water availability would not have states as a cataloging feature. However, streamgage is within a state, county, HUC, congressional district, etc and may be tagged with these features in metadata, and thus be filtered alongside other streamgages within the same state.</p></li>
</ul>
<p>This Geoconnex guidance concerns how to explicitly publish metadata that describes Datasets how they are related to each of the other elements of the information model.</p>
</section>
<section id="sec-primer" class="level2" data-number="1.2">
<h2 data-number="1.2" class="anchored" data-anchor-id="sec-primer"><span class="header-section-number">1.2</span> JSON-LD Primer</h2>
<p>JSON-LD is a version of JSON, the popular data exchange format used by web APIs, to express linked data. Linked Data is an approach to data publication that allows data from various sources to be easily integrated. JSON-LD accomplishes this by mapping terms from a source data system to a machine-readable definition of that term available on the web, allowing different attribute names from different data sources to be consistently interpreted together. Commonly, JSON-LD is embedded within websites, allowing search engines and applications to parse the information available from web addresses (URLs). For an in-depth exploration and multimedia resources, refer to the <a href="https://json-ld.org">JSON-LD official site</a> and its <a href="https://json-ld.org/learn.html">learning section</a>. JSON-LD documents should be embedded in the HTML of websites using script headers. A brief overview of the JSON-LD format follows below.</p>
<p>Below is an example JSON-LD document as embedded in a <code><script></code> division within a <code><head></code> or <code><body></code> section of an HTML page, with an explanation of its major elements.</p>
<div class="sourceCode" id="cb1"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb1-1"><a href="#cb1-1"></a><span class="er"><script</span> <span class="er">type="application/ld+json"></span> </span>
<span id="cb1-2"><a href="#cb1-2"></a><span class="fu">{</span></span>
<span id="cb1-3"><a href="#cb1-3"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb1-4"><a href="#cb1-4"></a> <span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"https://schema.org/"</span><span class="fu">,</span></span>
<span id="cb1-5"><a href="#cb1-5"></a> <span class="dt">"ex"</span><span class="fu">:</span> <span class="st">"https://example.com/schema/"</span><span class="fu">,</span></span>
<span id="cb1-6"><a href="#cb1-6"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType"</span></span>
<span id="cb1-7"><a href="#cb1-7"></a> <span class="fu">},</span></span>
<span id="cb1-8"><a href="#cb1-8"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://example.com/well/1234"</span><span class="fu">,</span></span>
<span id="cb1-9"><a href="#cb1-9"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"schema:Place"</span><span class="fu">,</span></span>
<span id="cb1-10"><a href="#cb1-10"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Well 1234"</span><span class="fu">,</span></span>
<span id="cb1-11"><a href="#cb1-11"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Well at 1234 Place St., USA"</span><span class="fu">,</span></span>
<span id="cb1-12"><a href="#cb1-12"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"well"</span><span class="fu">,</span></span>
<span id="cb1-13"><a href="#cb1-13"></a> <span class="dt">"subjectOf"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb1-14"><a href="#cb1-14"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://datasystem.org/dataset1"</span><span class="fu">,</span></span>
<span id="cb1-15"><a href="#cb1-15"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"schema:Dataset"</span><span class="fu">,</span></span>
<span id="cb1-16"><a href="#cb1-16"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Well Locations Dataset"</span><span class="fu">,</span></span>
<span id="cb1-17"><a href="#cb1-17"></a> <span class="dt">"ex:recordCount"</span><span class="fu">:</span> <span class="dv">500</span></span>
<span id="cb1-18"><a href="#cb1-18"></a> <span class="fu">}</span></span>
<span id="cb1-19"><a href="#cb1-19"></a><span class="fu">}</span></span>
<span id="cb1-20"><a href="#cb1-20"></a><span class="er"><script></span> </span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p><strong><code><script type="application/ld+json"></code>, <code><script></code></strong> These are immutable HTML elements that tell machines to interpret everything between them as JSON-LD.</p>
<p><strong><code>@context</code></strong> The <code>@context</code> keyword in JSON-LD sets the stage for interpreting the data by mapping terms to IRIs (Internationalized Resource Identifiers). By doing so, properties and values are clearly defined and identified. Our updated example has two contexts:</p>
<ul>
<li><code>@vocab</code>: Sets the default document vocabulary to <code>https://schema.org/</code>, which is a standard vocabulary for web-based structured data. This means that in general, attributes in the document will be assumed to have <code>https://schema.org/</code> as a prefix, so JSON-LD parsers will map <code>name</code> to <a href="https://schema.org/name" class="uri">https://schema.org/name</a></li>
<li><code>ex</code>: This is a custom context prefix representing <code>https://example.com/schema/</code>, signifying specific extensions or custom data definitions specific to our website. The prefix can be used on other attributes so that JSON-LD parsers do the appropriate mapping. Thus, <code>ex:name</code> will be parsed as <code>https://example.com/schema/recordCount</code>.</li>
<li><code>locType</code>: This is a custom direct attribute mapping, specifying that this attribute exactly matches to the concept identified by this HTTP identifier <a href="https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType" class="uri">https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType</a>. Using this direct mapping approach allows data publishers to map their arbitrary terminology to any publicly accessibly and well-identified standard term.</li>
</ul>
<p><strong><code>@id</code></strong> The <code>@id</code> keyword furnishes a uniform resource identifier (URI) for subjects in the JSON-LD document, enabling the subjects to be interconnected with data elsewhere. In this example:</p>
<ul>
<li>Well 1234 has the identifier <code>https://example.com/well/1234</code>.</li>
<li>The dataset that it is about, “Well Locations Dataset”, has its unique identifier as <code>https://datasystem.org/dataset1</code>.</li>
</ul>
<p><strong><code>@type</code></strong> The <code>@type</code> keyword stipulates the type or nature of the subject or node in the JSON-LD. It aids in discerning the entity being depicted. In the given context:</p>
<ul>
<li>Well 1234 is specified as a “Place” from the schema.org vocabulary (<code>schema:Place</code>).</li>
<li>Well Locations Dataset’s type is a “Dataset” from the schema.org vocabulary (<code>schema:Dataset</code>).</li>
</ul>
<p><strong>Nodes</strong> Nodes represent entities in JSON-LD, with each entity having properties associated with it. In the example:</p>
<ul>
<li>The main node is Well 1234, possessing properties like “name”, “description”, “locType”, and “subjectOf”.</li>
<li>subjectOf property itself is a node representing a dataset that is about Well 1234. Apart from the “name” property, the dataset now also has a property called “ex:recordCount” (using the <code>ex:</code> prefix from <code>@context</code>) indicating the number of rows in the dataset. This extension showcases the flexibility and strength of JSON-LD, where you can seamlessly integrate standard vocabulary with custom definitions, ensuring rich and well-structured interconnected data representations. Below, you can see how JSON-LD tools would parse and standardize the JSON-LD in the example.</li>
</ul>
<iframe width="780" height="500" src="https://tinyurl.com/29qaectm" title="JSON-LD playground"></iframe>
</section>
<section id="sec-jsonldelem" class="level2" data-number="1.3">
<h2 data-number="1.3" class="anchored" data-anchor-id="sec-jsonldelem"><span class="header-section-number">1.3</span> Geoconnex JSON-LD elements</h2>
<p>A Geoconnex JSON-LD document should be embedded in a human-readable website that is about either a <strong>Location</strong> or a <strong>Dataset</strong>. Documents about <strong>Locations</strong> should ideally include references to relevant <strong>Hydrologic Features</strong>, <strong>Cataloging Features</strong>, and <strong>Datasets</strong>. Documents about <strong>Datasets</strong> <em>must</em> include references to one or more relevant Reference <strong>Monitoring Locations</strong> or <strong>Hydrologic Features</strong> or <strong>Cataloging Features</strong>, or declare their spatial coverage.</p>
<section id="sec-context" class="level3" data-number="1.3.1">
<h3 data-number="1.3.1" class="anchored" data-anchor-id="sec-context"><span class="header-section-number">1.3.1</span> Context</h3>
<p>Geoconnex JSON-LD documents can have varying contexts. However, there are several vocabularies other than <code>schema.org</code> that mqy be useful, depending on the type of location and dataset being described and the level of specificity for which metadata is produced by the data provider. The example context below can serve as general-purpose starting point, although simpler contexts may be sufficient for many documents:</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb2-1"><a href="#cb2-1"></a> <span class="er">"@context":</span> <span class="fu">{</span></span>
<span id="cb2-2"><a href="#cb2-2"></a> <span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"https://schema.org/"</span><span class="fu">,</span> </span>
<span id="cb2-3"><a href="#cb2-3"></a> <span class="dt">"rdfs"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/2000/01/rdf-schema#"</span><span class="fu">,</span></span>
<span id="cb2-4"><a href="#cb2-4"></a> <span class="dt">"dc"</span><span class="fu">:</span> <span class="st">"http://purl.org/dc/terms/"</span><span class="fu">,</span></span>
<span id="cb2-5"><a href="#cb2-5"></a> <span class="dt">"qudt"</span><span class="fu">:</span> <span class="st">"http://qudt.org/schema/qudt/"</span><span class="fu">,</span></span>
<span id="cb2-6"><a href="#cb2-6"></a> <span class="dt">"qudt-units"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/unit/"</span><span class="fu">,</span></span>
<span id="cb2-7"><a href="#cb2-7"></a> <span class="dt">"qudt-quantkinds"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/quantitykind/"</span><span class="fu">,</span></span>
<span id="cb2-8"><a href="#cb2-8"></a> <span class="dt">"gsp"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#"</span><span class="fu">,</span></span>
<span id="cb2-9"><a href="#cb2-9"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype"</span><span class="fu">,</span></span>
<span id="cb2-10"><a href="#cb2-10"></a> <span class="dt">"odm2var"</span><span class="fu">:</span><span class="st">"http://vocabulary.odm2.org/variablename/"</span><span class="fu">,</span></span>
<span id="cb2-11"><a href="#cb2-11"></a> <span class="dt">"odm2varType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variabletype/"</span><span class="fu">,</span></span>
<span id="cb2-12"><a href="#cb2-12"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb2-13"><a href="#cb2-13"></a> <span class="dt">"skos"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType"</span><span class="fu">,</span></span>
<span id="cb2-14"><a href="#cb2-14"></a> <span class="dt">"ssn"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/"</span><span class="fu">,</span></span>
<span id="cb2-15"><a href="#cb2-15"></a> <span class="dt">"ssn-system"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/systems/"</span></span>
<span id="cb2-16"><a href="#cb2-16"></a> <span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<ul>
<li><p><a href="https://www.w3.org/TR/rdf12-schema/"><code>rdfs</code></a> is a general vocabulary for basic relationships</p></li>
<li><p><a href="https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#"><code>dc</code></a> is the <a href="https://www.dublincore.org/specifications/dublin-core/dcmi-terms/">Dublin Core</a> vocabulary for general information metadata attributes</p></li>
<li><p><a href="https://www.qudt.org/doc/DOC_VOCAB-UNITS.html"><code>qudt-units</code></a> provides standard identifiers for units (e.g. <a href="https://qudt.org/vocab/unit/FT3-PER-SEC">cubic feet per second</a>)</p></li>
<li><p><a href="https://www.qudt.org/doc/DOC_VOCAB-QUANTITY-KINDS.html"><code>qudt-quantkinds</code></a> provides ids for general phenomena (e.g. <a href="https://qudt.org/vocab/quantitykind/VolumeFlowRate">Volume flow rate</a>) which may be measured in various units</p></li>
<li><p><a href="http://defs.opengis.net/vocprez/object?uri=http://www.opengis.net/def/function/geosparql"><code>gsp</code></a> provides ids for spatial relationships (e.g. intersects)</p></li>
<li><p><a href="http://vocabulary.odm2.org/variablename"><code>odm2var</code></a> is a supplement to <code>qudt-quantkinds</code>, and includes ids for many variables relevant to water science and management (e.g. <a href="http://vocabulary.odm2.org/variablename/turbidity/">turbidity</a>)</p></li>
<li><p><a href="http://vocabulary.odm2.org/variabletype/"><code>odm2varType</code></a> is a supplement to <code>odm2var</code> that includes ids for large groupings of variables (e.g. <a href="http://vocabulary.odm2.org/variabletype/WaterQuality/">Water Quality</a>)</p></li>
<li><p><a href="https://www.opengis.net/def/schema/hy_features/hyf/"><code>hyf</code></a> provides ids for surface water hydrology concepts (e.g. <a href="https://defs.opengis.net/vocprez/object?uri=https%3A//www.opengis.net/def/schema/hy_features/hyf/HY_River">streams</a>)</p></li>
<li><p><a href="https://www.w3.org/TR/swbp-skos-core-spec/"><code>skos</code></a> provides general properties for relating different concepts (e.g. broader, <a href="https://www.w3.org/2009/08/skos-reference/skos.html#narrower">narrower,</a> exact Match)</p></li>
<li><p><a href="https://www.w3.org/TR/vocab-ssn/"><code>ssn</code></a> and <code>ssn-system</code> provide ids for aspects of observations and measurement (e.g. measurement methods)</p></li>
</ul>
</section>
<section id="sec-ref" class="level3" data-number="1.3.2">
<h3 data-number="1.3.2" class="anchored" data-anchor-id="sec-ref"><span class="header-section-number">1.3.2</span> Reference Features</h3>
<p>Embedding links to URIs of Reference Features are the best way to ensure that your data can be related to other data providers’ data. URIs for reference features are available from <a href="https://reference.geoconnex.us/collections">the Geoconnex reference feature server</a>. Reference features can be one of three types:</p>
<ul>
<li><strong>Monitoring Locations</strong> which are common locations that many organizations might have data about such as a streamgage station e.g. <a href="https://geoconnex.us/ref/gages/1143822" class="uri">https://geoconnex.us/ref/gages/1143822</a></li>
<li><strong>Hydrologic Features</strong> which are common specific features of the hydrologic landscape that many organizations have data about. These could include confluence points, aquifers, stream segments and river mainstems and named tributaries, e.g. <a href="https://geoconnex.us/ref/mainstems/29559" class="uri">https://geoconnex.us/ref/mainstems/29559</a>.</li>
<li><strong>Cataloging Features</strong> which are larger area units that are commonly used to group and filter data, such as <a href="https://geoconnex.us/ref/hu04/0308">HUCs</a><a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a>, <a href="https://geoconnex.us/ref/states/48">states</a><a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a>, <a href="https://geoconnex.us/ref/counties/37003">counties</a><a href="#fn3" class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</sup></a>, PLSS grids, public agency operating districts, etc.</li>
</ul>
</section>
</section>
</section>
<section id="sec-step-by-step" class="level1" data-number="2">
<h1 data-number="2"><span class="header-section-number">2</span> Building Geoconnex Web Resources, Step-by-Step</h1>
<p>This section provides step-by-step guidance to build Geoconnex Web Resources, which should be an HTML webpage with a unique URL within which is embedded an JSON-LD document (see <a href="#sec-primer">Section 1.2</a>). See <a href="#sec-complete-examples">Section 2.2</a> for completed example documents to skip the step-by-step.</p>
<section id="location-or-dataset-oriented" class="level2" data-number="2.1">
<h2 data-number="2.1" class="anchored" data-anchor-id="location-or-dataset-oriented"><span class="header-section-number">2.1</span> Location or Dataset oriented?</h2>
<p>Depending on what kind of resource i.e. (location or dataset) and the level of metadata you have available to publish, you can use different elements of the <code>@context</code> or use Reference Features in various ways. Below we will work through creating a JSON-LD document depending on your situation.</p>
<p>There are two basic patterns to think about:</p>
<ol type="1">
<li><p><code>Location-oriented</code> webpages that include a catalog of parameters and periods of record for which there is data about the location. This pattern may be suitable where data can be accessed separately for each location and possibly for each parameter for each location. This is typical of streamgages, monitoring wells, water diversions, reservoirs, regulated effluent discharge locations, etc. where there is an ongoing monitoring or modeling program that includes data collection or generation for multiple parameters. The Monitor My Watershed Site pages published by the <a href="https://stroudcenter.org">Stroud Center</a> are an example of this pattern. At <a href="https://monitormywatershed.org/sites/RH_MD/">this page</a>, one finds a variety of information about a specific location, such as that location’s identifier and name and a map of where it is. In addition there is information about which continuous sensor and field water quality sample data are available about the location, and links to download these data.</p></li>
<li><p><code>Dataset-oriented</code> webpages that tag which locations are relevant to the dataset described at a given page. This pattern may be suitable for static datasets where data was collected or modeled for a consistent set of parameters for a pre-specified research question and time period across one or more locations, and where it would not make sense to publish separate metadata for the parts of the dataset that are relevant to each individual feature and parameter. This is typical of datasets created for, and published in association withm scientific and regulatory studies. <a href="https://www.hydroshare.org/resource/11dd1840fe6a48abb9a33380ecaa6e1d/">This dataset record</a> published on <a href="https://cuahsi.org">CUAHSI</a>’s <a href="https://hydroshare.org">Hydroshare</a> platform is an example, where there is a “Related Geospatial Features” section that explicitly identifies several features that the dataset has data about.</p></li>
</ol>
<p>In some cases, it is possible to set up a web architecture that implements both patterns. For example, the <a href="https://seoflow.wyo.gov">Wyoming State Engineer’s Office Web Portal</a> conceptualizes a time series for a specific parameter at a specific location as a dataset. Thus, webpages exist for both <a href="https://seoflow.wyo.gov/Data/Location/Summary/Location/06280300/Interval/Latest">Locations</a> and <a href="https://seoflow.wyo.gov/Data/DataSet/Summary/Location/06280300/DataSet/Discharge/Discharge/Interval/Latest">Datasets</a>, and they link to each other where relevant. In this case, it is only necessary to implement Geoconnex embedded JSON-LD at either the Location or Dataset level, although both could be done as well.</p>
<p>Having chosen one of the patterns, proceed to <a href="@sec-loc">location-oriented</a> or <a href="@sec-data">dataset-oriented</a> guidance to start building a JSON-LD document.</p>
<section id="sec-loc" class="level3" data-number="2.1.1">
<h3 data-number="2.1.1" class="anchored" data-anchor-id="sec-loc"><span class="header-section-number">2.1.1</span> Location-oriented</h3>
<p>The purpose of the location-oriented page is to give enough information about the location and the data available about that location that a water data user would be able to quickly determine whether and how to download the data after reading. We will use the USGS Monitoring Location <a href="https://geoconnex.us/usgs/monitoring-location/08282300">08282300</a> as an example for the type of content to put in location-oriented Geoconnex landing page web resources and how to map that content to embedded JSON-LD documents.</p>
<div class="callout callout-style-default callout-note callout-titled">
<div class="callout-header d-flex align-content-center">
<div class="callout-icon-container">
<i class="callout-icon"></i>
</div>
<div class="callout-title-container flex-fill">
Note
</div>
</div>
<div class="callout-body-container callout-body">
<p>Scroll up and down to view elements of the example landing page</p>
</div>
</div>
<iframe width="780" height="500" src="https://waterdata.usgs.gov/monitoring-location/08282300" title="USGS Example"></iframe>
<p>This location-oriented web resource includes this type of information</p>
<ul>
<li><p>“<a href="https://geoconnex.us/ref/monitoring-location/08282300">This is my HTTP identifier</a>”<a href="#fn4" class="footnote-ref" id="fnref4" role="doc-noteref"><sup>4</sup></a></p></li>
<li><p>“I am the same thing as <a href="https://geoconnex.us/ref/gages/1018463">Geoconnex Reference Gage 1018463</a>”<a href="#fn5" class="footnote-ref" id="fnref5" role="doc-noteref"><sup>5</sup></a></p></li>
<li><p>“My unique USGS ID is <code>08282300</code>”</p></li>
<li><p>“My name is <code>Rio Brazos at Fishtail Road NR Tierra Amarilla, NM</code>”</p></li>
<li><p>“Data about me is provided by the <code>USGS Water Data for the Nation</code>”</p></li>
<li><p>“I am a <code>hydrometric station</code><a href="#fn6" class="footnote-ref" id="fnref6" role="doc-noteref"><sup>6</sup></a>”</p></li>
<li><p>“My lat/long is <code>36.738 -106.471</code>”</p></li>
<li><p>“I am on the <a href="https://geoconnex.us/ref/mainstems/1611418">Rio Brazos</a>”<a href="#fn7" class="footnote-ref" id="fnref7" role="doc-noteref"><sup>7</sup></a></p></li>
<li><p>“There is data about me for the parameter <code>Discharge</code> and between June 6, 2014 to the present at a 15 minute time resolution. This data is generated from <code>in-situ observation</code>, in particular using <a href="https://pubs.usgs.gov/publication/tm3A8">USGS discharge measurement methods</a>. You can download it <a href="https://waterservices.usgs.gov/nwis/iv/?sites=08282300&parameterCd=00060&startDT=2023-08-13T03:08:21.313-06:00&endDT=2023-08-20T03:08:21.313-06:00&siteStatus=all&format=rdb">here</a> using the <a href="https://waterservices.usgs.gov/rest/IV-Test-Tool.html">USGS Instantaneous Values REST Web Service</a> in the <a href="https://waterdata.usgs.gov/nwis/?tab_delimited_format_info">RDB format</a>”. You can also download it <a href="https://labs.waterdata.usgs.gov/sta/v1.1/Datastreams('0adb31f7852e4e1c9a778a85076ac0cf')?$expand=Thing,Observations">here</a> using the <a href="https://docs.ogc.org/is/15-078r6/15-078r6.html">SensorThings API standard</a> in <code>JSON</code> or <code>CSV</code> formats.”<a href="#fn8" class="footnote-ref" id="fnref8" role="doc-noteref"><sup>8</sup></a></p></li>
<li><p>“There is data about me for the parameter <code>Gage Height</code> between June 6, 2014 to the present at a 15 minute time resolution. This data is generated from <code>in-situ observation</code>, in particular using <a href="https://pubs.usgs.gov/publication/tm3A7">USGS stage measurement methods</a>. You can download it <a href="https://waterservices.usgs.gov/nwis/iv/?sites=08282300&parameterCd=00065&startDT=2023-08-13T03:08:21.313-06:00&endDT=2023-08-20T03:08:21.313-06:00&siteStatus=all&format=rdb">here</a> from the <a href="https://waterservices.usgs.gov/rest/IV-Test-Tool.html">USGS Instantaneous Values REST Web Service</a> in the <a href="https://waterdata.usgs.gov/nwis/?tab_delimited_format_info">RDB format</a>”. You can also download it <a href="https://labs.waterdata.usgs.gov/sta/v1.1/Datastreams('ba774169b3e542cdb9c02e8d705b4d0f')?$expand=Thing,Observations">here</a> using the <a href="https://docs.ogc.org/is/15-078r6/15-078r6.html">SensorThings API standard</a> in <code>JSON</code> or <code>CSV</code> formats.”</p></li>
</ul>
<section id="json-ld" class="level4" data-number="2.1.1.1">
<h4 data-number="2.1.1.1" class="anchored" data-anchor-id="json-ld"><span class="header-section-number">2.1.1.1</span> JSON-LD</h4>
<p>Here we will build the equivalent JSON-LD content step-by-step. The steps are:</p>
<ol type="1">
<li><a href="#sec-ident">Identifiers and provenance</a></li>
<li><a href="#sec-spatial">Spatial geometry and hydrologic references</a></li>
<li><a href="#sec-loc-data">Datasets</a></li>
</ol>
<p>These culmminate in the <a href="">complete example</a>.</p>
<section id="sec-ident" class="level5" data-number="2.1.1.1.1">
<h5 data-number="2.1.1.1.1" class="anchored" data-anchor-id="sec-ident"><span class="header-section-number">2.1.1.1.1</span> Identifiers and provenance</h5>
<p>A first group of information helps identify the location and its provenance.</p>
<ul>
<li><p>“<a href="https://geoconnex.us/usgs/monitoring-location/08282300">This is my HTTP identifier</a>”<a href="#fn9" class="footnote-ref" id="fnref9" role="doc-noteref"><sup>9</sup></a></p></li>
<li><p>“I am a <code>hydrometric station</code><a href="#fn10" class="footnote-ref" id="fnref10" role="doc-noteref"><sup>10</sup></a>”</p></li>
<li><p>“I am the same thing as <a href="https://geoconnex.us/ref/gages/1018463">Geoconnex Reference Gage 1018463</a>”<a href="#fn11" class="footnote-ref" id="fnref11" role="doc-noteref"><sup>11</sup></a></p></li>
<li><p>“My unique USGS ID is <code>08282300</code>”</p></li>
<li><p>“My name is <code>Rio Brazos at Fishtail Road NR Tierra Amarilla, NM</code>”</p></li>
<li><p>“Data about me is provided by the <code>USGS Water Data for the Nation</code>”</p></li>
</ul>
<div class="sourceCode" id="cb3"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb3-1"><a href="#cb3-1"></a><span class="fu">{</span></span>
<span id="cb3-2"><a href="#cb3-2"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb3-3"><a href="#cb3-3"></a> <span class="dt">"@vocab"</span><span class="fu">:</span><span class="st">"https://schema.org/"</span><span class="fu">,</span></span>
<span id="cb3-4"><a href="#cb3-4"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb3-5"><a href="#cb3-5"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype/"</span></span>
<span id="cb3-6"><a href="#cb3-6"></a> <span class="fu">},</span></span>
<span id="cb3-7"><a href="#cb3-7"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/usgs/monitoring-location/08282300"</span><span class="fu">,</span></span>
<span id="cb3-8"><a href="#cb3-8"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb3-9"><a href="#cb3-9"></a> <span class="st">"hyf:HY_HydrometricFeature"</span><span class="ot">,</span></span>
<span id="cb3-10"><a href="#cb3-10"></a> <span class="st">"hyf:HY_HydroLocation"</span><span class="ot">,</span></span>
<span id="cb3-11"><a href="#cb3-11"></a> <span class="st">"locType:stream"</span></span>
<span id="cb3-12"><a href="#cb3-12"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb3-13"><a href="#cb3-13"></a> <span class="dt">"hyf:HydroLocationType"</span><span class="fu">:</span> <span class="st">"hydrometric station"</span><span class="fu">,</span></span>
<span id="cb3-14"><a href="#cb3-14"></a> <span class="dt">"sameAs"</span><span class="fu">:</span> <span class="fu">{</span><span class="dt">"@id"</span><span class="fu">:</span><span class="st">"https://geoconnex.us/ref/gages/1018463"</span><span class="fu">},</span></span>
<span id="cb3-15"><a href="#cb3-15"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb3-16"><a href="#cb3-16"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="cb3-17"><a href="#cb3-17"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"USGS site number"</span><span class="fu">,</span></span>
<span id="cb3-18"><a href="#cb3-18"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"08282300"</span></span>
<span id="cb3-19"><a href="#cb3-19"></a> <span class="fu">},</span></span>
<span id="cb3-20"><a href="#cb3-20"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<span id="cb3-21"><a href="#cb3-21"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Stream/River Site"</span><span class="fu">,</span></span>
<span id="cb3-22"><a href="#cb3-22"></a> <span class="dt">"provider"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb3-23"><a href="#cb3-23"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://waterdata.usgs.gov"</span><span class="fu">,</span></span>
<span id="cb3-24"><a href="#cb3-24"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"GovernmentOrganization"</span><span class="fu">,</span></span>
<span id="cb3-25"><a href="#cb3-25"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"U.S. Geological Survey Water Data for the Nation"</span></span>
<span id="cb3-26"><a href="#cb3-26"></a> <span class="fu">}</span></span>
<span id="cb3-27"><a href="#cb3-27"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Here we construct the JSON-LD document by adding a context which includes the <a href="https://schema.org/" class="uri">https://schema.org/</a> vocabulary, as well as the <a href="https://www.opengis.net/def/schema/hy_features/hyf/" class="uri">https://www.opengis.net/def/schema/hy_features/hyf/</a> vocabulary which defines specific concepts in surface hydrology, and the ODM2 <a href="http://vocabulary.odm2.org/sitetype/">sitetype vocabulary</a> which defines types of water data collection locations.</p>
<ul>
<li><p>The <code>@id</code> element of <a href="https://geoconnex.us/ref/monitoring-location/08282300" class="uri">https://geoconnex.us/ref/monitoring-location/08282300</a> in this case is a persistent geoconnex URI. See <a href="https://github.com/internetofwater/geoconnex.us/blob/master/CONTRIBUTING.md">here</a> for how to create these. It is optional if the “same thing” geoconnex URI in the next bullet is provided, in which case this could just be the URL of the web resource for the location, or omitted.</p></li>
<li><p>The <code>@type</code> element here specifies that <a href="https://geoconnex.us/ref/monitoring-location/08282300" class="uri">https://geoconnex.us/ref/monitoring-location/08282300</a> is a <a href="https://schema.org/Place">Place</a> (i.e. a generic place on earth), a <a href="https://www.opengis.net/def/schema/hy_features/hyf/HY_HydrometricFeature">Hydrometric Feature</a> (i.e. a data collection station) and a <a href="https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocation">HydroLocation</a> (i.e. a specific location that could in principle define a catchment). The <code>locType</code> further specifies the type of location using the ODM2 sitetype vocabulary <a href="http://vocabulary.odm2.org/sitetype/" class="uri">http://vocabulary.odm2.org/sitetype/</a>, which expresses the location type in terms of the feature of interest (e.g. a stream, a groundwater system). If the location is more meant to represent a general location about which non-hydrologic data is being provided, as might be the case with a data provider publishing data about dams, levees, culverts, bridges, etc. but not associated water data, then <code>locType</code> and <code>hyf:HY_HydrometricFeature</code> can be omitted.</p></li>
<li><p>The <code>hyf:HydroLocationType</code> can be used to identify the type of site with greater specificity and customization by using text values from any codelist, but preferably the <a href="https://docs.ogc.org/is/14-111r6/14-111r6.html#annexB_1">HY_Features HydroLocationType codelist</a> instead of identifiers. It can be useful to describe something like a dam, weir, culvert, bridge, etc.</p></li>
<li><p>The <code>sameAs</code> element is optional if the <code>@id</code> element is included as a persistent geoconnex URI. However, wherever possible, it should be populated with a Geoconnex Reference Feature URI. If all data providers tag their own location metadata with these, it becomes much more easy for users of the Geoconnex system to find data collected by other providers about the same location. Reference features of all sorts are available to browse in a web map at <a href="https://geoconnex.us/iow/map" class="uri">https://geoconnex.us/iow/map</a>, access via API at <a href="https://reference.geoconnex.us/collections" class="uri">https://reference.geoconnex.us/collections</a>, or to download in bulk as GeoPackage files from <a href="https://www.hydroshare.org/resource/3cc04df349cd45f38e1637305c98529c/">HydroShare</a>. If your location does not appear to be represented in a reference location, please consider contributing your location. You can start this process by <a href="https://github.com/internetofwater/geoconnex.us/issues/new?assignees=&labels=&projects=&template=general.md&title=%5Bgeneral%5D">submitting an issue at the geoconnex.us GitHub repository</a>. In this case <code>sameAs</code> is a persistent geoconnex URI for a “Reference Gage”. Reference Gages is an open source, continuously updated set of all known surface water monitoring locations with data being collected by all known organizations. It is managed on GitHub at <a href="https://github.com/internetofwater/ref_gages" class="uri">https://github.com/internetofwater/ref_gages</a></p></li>
<li><p>The <code>identifier</code> element specifies the ID scheme name (<code>propertyID</code>) for the location in the data source and the ID itself (<code>value</code>)</p></li>
<li><p>The <code>name</code> (required) and <code>description</code> (optional) elements are self-explanatory and can follow the conventions of the data provider.</p></li>
<li><p>The <code>provider</code> element describes the data provider, which is generally conceptualized in Geoconnex as being a data system available on the web. Note that under <code>provider</code>, in addition to an identifying <code>name</code>, there is a <code>url</code> if available for the website of the providing data system, and a <code>@type</code>, which is most likely a sub type of <a href="https://schema.org/Organization" class="uri">https://schema.org/Organization</a>, which includes <a href="https://schema.org/GovernmentOrganization">GovernmentOrganization</a>, <a href="https://schema.org/NGO">NGO</a>, <a href="https://schema.org/ResearchOrganization">ResearchOrganization</a>, <a href="https://schema.org/EducationalOrganization">EducationalOrganization</a>, and <a href="https://schema.org/Corporation">Corporation</a>, among others.</p></li>
</ul>
</section>
<section id="sec-spatial" class="level5" data-number="2.1.1.1.2">
<h5 data-number="2.1.1.1.2" class="anchored" data-anchor-id="sec-spatial"><span class="header-section-number">2.1.1.1.2</span> Spatial geometry and hydrologic references</h5>
<p>The second group of information provides specific location and spatial context:</p>
<ul>
<li><p>“My lat/long is <code>36.738 -106.471</code>”</p></li>
<li><p>“I am on the <a href="https://geoconnex.us/ref/mainstems/1611418">Rio Brazos</a>”<a href="#fn12" class="footnote-ref" id="fnref12" role="doc-noteref"><sup>12</sup></a></p></li>
</ul>
<p>Adding this information to the bottom of JSON-LD document:</p>
<div class="sourceCode" id="cb4"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb4-1"><a href="#cb4-1"></a><span class="fu">{</span></span>
<span id="cb4-2"><a href="#cb4-2"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-3"><a href="#cb4-3"></a> <span class="dt">"@vocab"</span><span class="fu">:</span><span class="st">"https://schema.org/"</span><span class="fu">,</span></span>
<span id="cb4-4"><a href="#cb4-4"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb4-5"><a href="#cb4-5"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype/"</span></span>
<span id="cb4-6"><a href="#cb4-6"></a> <span class="fu">},</span></span>
<span id="cb4-7"><a href="#cb4-7"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/usgs/monitoring-location/08282300"</span><span class="fu">,</span></span>
<span id="cb4-8"><a href="#cb4-8"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb4-9"><a href="#cb4-9"></a> <span class="st">"hyf:HY_HydrometricFeature"</span><span class="ot">,</span></span>
<span id="cb4-10"><a href="#cb4-10"></a> <span class="st">"hyf:HY_HydroLocation"</span><span class="ot">,</span></span>
<span id="cb4-11"><a href="#cb4-11"></a> <span class="st">"locType:stream"</span></span>
<span id="cb4-12"><a href="#cb4-12"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb4-13"><a href="#cb4-13"></a> <span class="dt">"hyf:HydroLocationType"</span><span class="fu">:</span> <span class="st">"hydrometric station"</span><span class="fu">,</span></span>
<span id="cb4-14"><a href="#cb4-14"></a> <span class="dt">"sameAs"</span><span class="fu">:</span> <span class="fu">{</span><span class="dt">"@id"</span><span class="fu">:</span><span class="st">"https://geoconnex.us/ref/gages/1018463"</span><span class="fu">},</span></span>
<span id="cb4-15"><a href="#cb4-15"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-16"><a href="#cb4-16"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="cb4-17"><a href="#cb4-17"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"USGS site number"</span><span class="fu">,</span></span>
<span id="cb4-18"><a href="#cb4-18"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"08282300"</span></span>
<span id="cb4-19"><a href="#cb4-19"></a> <span class="fu">},</span></span>
<span id="cb4-20"><a href="#cb4-20"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<span id="cb4-21"><a href="#cb4-21"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Stream/River Site"</span><span class="fu">,</span></span>
<span id="cb4-22"><a href="#cb4-22"></a> <span class="dt">"provider"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-23"><a href="#cb4-23"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://waterdata.usgs.gov"</span><span class="fu">,</span></span>
<span id="cb4-24"><a href="#cb4-24"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"GovernmentOrganization"</span><span class="fu">,</span></span>
<span id="cb4-25"><a href="#cb4-25"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"U.S. Geological Survey Water Data for the Nation"</span></span>
<span id="cb4-26"><a href="#cb4-26"></a> <span class="fu">},</span></span>
<span id="cb4-27"><a href="#cb4-27"></a> <span class="dt">"geo"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-28"><a href="#cb4-28"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"schema:GeoCoordinates"</span><span class="fu">,</span></span>
<span id="cb4-29"><a href="#cb4-29"></a> <span class="dt">"longitude"</span><span class="fu">:</span> <span class="fl">-106.4707722</span><span class="fu">,</span></span>
<span id="cb4-30"><a href="#cb4-30"></a> <span class="dt">"latitude"</span><span class="fu">:</span> <span class="fl">36.7379333</span></span>
<span id="cb4-31"><a href="#cb4-31"></a> <span class="fu">},</span></span>
<span id="cb4-32"><a href="#cb4-32"></a> <span class="dt">"gsp:hasGeometry"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-33"><a href="#cb4-33"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/sf#Point"</span><span class="fu">,</span></span>
<span id="cb4-34"><a href="#cb4-34"></a> <span class="dt">"gsp:asWKT"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-35"><a href="#cb4-35"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#wktLiteral"</span><span class="fu">,</span></span>
<span id="cb4-36"><a href="#cb4-36"></a> <span class="dt">"@value"</span><span class="fu">:</span> <span class="st">"POINT (-106.4707722 36.7379333)"</span></span>
<span id="cb4-37"><a href="#cb4-37"></a> <span class="fu">},</span></span>
<span id="cb4-38"><a href="#cb4-38"></a> <span class="dt">"gsp:crs"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb4-39"><a href="#cb4-39"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/def/crs/OGC/1.3/CRS84"</span></span>
<span id="cb4-40"><a href="#cb4-40"></a> <span class="fu">}</span></span>
<span id="cb4-41"><a href="#cb4-41"></a> <span class="fu">},</span></span>
<span id="cb4-42"><a href="#cb4-42"></a> <span class="dt">"hyf:referencedPosition"</span><span class="fu">:{</span></span>
<span id="cb4-43"><a href="#cb4-43"></a> <span class="dt">"hyf:HY_IndirectPosition"</span><span class="fu">:{</span></span>
<span id="cb4-44"><a href="#cb4-44"></a> <span class="dt">"hyf:linearElement"</span><span class="fu">:{</span></span>
<span id="cb4-45"><a href="#cb4-45"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/mainstems/1611418"</span></span>
<span id="cb4-46"><a href="#cb4-46"></a> <span class="fu">}</span></span>
<span id="cb4-47"><a href="#cb4-47"></a> <span class="fu">}</span></span>
<span id="cb4-48"><a href="#cb4-48"></a> <span class="fu">}</span></span>
<span id="cb4-49"><a href="#cb4-49"></a> </span>
<span id="cb4-50"><a href="#cb4-50"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>We have added a context element <code>gsp</code> and three blocks: <code>geo</code>, <code>gsp:hasGeometry</code>, and <code>hyf:referencedPosition</code>.</p>
<ul>
<li><p><code>gsp</code> is the <a href="https://www.ogc.org/standard/geosparql/">GeoSPARQL</a> ontology used to standardize the representation of spatial data and relationships in knowledge graphs like the Geoconnex system</p></li>
<li><p><code>geo</code> is the <code>schema.org</code> <a href="https://schema.org/geo">standard for representing spatial data</a>. It is what is used by search engines like Google and Bing to place webpages on a map. While useful, it does not have a standard way for representing multipoint, multipolyline, or multipolygon features, or a way to specify coordinate reference systems or projections, and so we need to also provide a GeoSPARQL version of the geometry. In this case, we are simply providing a point with a longitude and latitude via the <a href="https://schema.org/GeoCoordinates">schema:GeoCoordinates</a> property. It is also possible to represent <a href="https://schema.org/line">lines</a> and <a href="https://schema.org/polygon">polygons</a></p></li>
<li><p><code>gsp:hasGeometry</code> is the GeoSPARQL version of geometry, with which we can embed <a href="https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry">WKT</a> representations of geometry in structured metadata in the <code>@value</code> element, and declare the coordinate reference system or projection in the <code>gsp:crs</code> element by using EPSG codes as encoded in the <a href="http://www.opengis.net/def/crs/EPSG/0/">OGC register of reference systems</a>, in this case using <a href="http://www.opengis.net/def/crs/EPSG/0/4326" class="uri">http://www.opengis.net/def/crs/EPSG/0/4326</a> for the familiar WGS 84 (EPSG 4326) system.</p></li>
<li><p><code>hyf:referencedPosition</code> uses the <a href="https://www.opengis.net/def/schema/hy_features/hyf/">HY_Features</a> model to declare that this location is located on a specific river, in this case the <a href="%22https://geoconnex.us/ref/mainstems/1611418%22">Rio Brazos in New Mexico</a> as identified in the Reference Mainstems dataset, which is available via API at <a href="https://reference.geoconnex.us/collections/mainstems" class="uri">https://reference.geoconnex.us/collections/mainstems</a> and managed on GitHub at <a href="https://github.com/internetofwater/ref_rivers" class="uri">https://github.com/internetofwater/ref_rivers</a>. All surface water locations should include this type of element.</p></li>
</ul>
<div class="callout callout-style-default callout-note callout-titled">
<div class="callout-header d-flex align-content-center">
<div class="callout-icon-container">
<i class="callout-icon"></i>
</div>
<div class="callout-title-container flex-fill">
What about groundwater?
</div>
</div>
<div class="callout-body-container callout-body">
<p>Groundwater monitoring locations may use the <code>hyf:referencedPosition</code> element if data providers wish their wells to be associated with specific streams. However, groundwater sample and monitoring locations such as wells can also be referenced to hydrogeologic unit or aquifer identifiers where available using this pattern, instead of using the <code>hyf:referencedPosition</code> pattern:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb5-1"><a href="#cb5-1"></a><span class="er">"http://www.w3.org/ns/sosa/isSampleOf":</span> <span class="fu">{</span></span>
<span id="cb5-2"><a href="#cb5-2"></a> <span class="dt">"id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/sec_hydrg_reg/S26"</span></span>
<span id="cb5-3"><a href="#cb5-3"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>USGS Principal Aquifers and Secondary Hydrogeologic Unit URIs are available from <a href="https://reference.geoconnex.us/collections" class="uri">https://reference.geoconnex.us/collections</a></p>
<p>If reference URIs are not available for the groundwater unit you’d like to reference, but an ID does exist in a dataset that exists online you may use this pattern</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb6-1"><a href="#cb6-1"></a><span class="er">"http://www.w3.org/ns/sosa/isSampleOf":</span> <span class="fu">{</span></span>
<span id="cb6-2"><a href="#cb6-2"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"GW_HydrogeoUnit"</span><span class="fu">,</span></span>
<span id="cb6-3"><a href="#cb6-3"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"name of the aquifer"</span><span class="fu">,</span></span>
<span id="cb6-4"><a href="#cb6-4"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb6-5"><a href="#cb6-5"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="cb6-6"><a href="#cb6-6"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"Source aquifer dataset id field name"</span><span class="fu">,</span></span>
<span id="cb6-7"><a href="#cb6-7"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"aq-id-1234"</span></span>
<span id="cb6-8"><a href="#cb6-8"></a> <span class="fu">},</span></span>
<span id="cb6-9"><a href="#cb6-9"></a> <span class="dt">"subjectOf"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb6-10"><a href="#cb6-10"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<span id="cb6-11"><a href="#cb6-11"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"url where dataset that descibes or includes the aquifer can be accessed"</span></span>
<span id="cb6-12"><a href="#cb6-12"></a> <span class="fu">}</span></span>
<span id="cb6-13"><a href="#cb6-13"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</div>
</div>
</section>
<section id="sec-loc-data" class="level5" data-number="2.1.1.1.3">
<h5 data-number="2.1.1.1.3" class="anchored" data-anchor-id="sec-loc-data"><span class="header-section-number">2.1.1.1.3</span> Datasets</h5>
<p>Now that we have described our location’s provenance, geospatial geometry, and association with any reference features , we now describe the data that can be accessed about that location. The simplest, most minimal way to do this is to add a block like this, which would be added to the bottom of the JSON-LD document we have created so far:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb7-1"><a href="#cb7-1"></a><span class="er">"subjectOf":</span> <span class="fu">{</span></span>
<span id="cb7-2"><a href="#cb7-2"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<span id="cb7-3"><a href="#cb7-3"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS-08282300"</span><span class="fu">,</span></span>
<span id="cb7-4"><a href="#cb7-4"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS-08282300 at Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<span id="cb7-5"><a href="#cb7-5"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://waterdata.usgs.gov/monitoring-location/08282300/#parameterCode=00060&period=P7D"</span></span>
<span id="cb7-6"><a href="#cb7-6"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Here, we simply declare that the location we have been working with is <code>subjectOf</code> of a <code>Dataset</code> with a name, description, and URL where information about the dataset can be found.</p>
<p>However, to enable data users (and search engines) to filter for your data using more standardized names for variables, and by temporal coverage and resolution, and determine if they want to use that data based on the methods used (such as whether it is observed or modeled/forecasted data), and possibly preview actual data values, it will be useful to include much more detailed metadata. In general, following <a href="https://github.com/ESIPFed/science-on-schema.org/blob/master/guides/Dataset.md">Science-on-Schema.org Guidelines</a> is recommended. We implement this guidance, with some extension, for the USGS Monitoring Location example. Hover over the code annotation bubbles on the right for translation and explanation:</p>
<div class="sourceCode" id="annotated-cell-6"><pre class="sourceCode numberSource json code-annotation-code number-lines code-with-copy code-annotated"><code class="sourceCode json"><span id="annotated-cell-6-1"><a href="#annotated-cell-6-1"></a><span class="fu">{</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="1">1</button><span id="annotated-cell-6-2" class="code-annotation-target"><a href="#annotated-cell-6-2"></a> <span class="dt">"subjectOf"</span><span class="fu">:{</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="2">2</button><span id="annotated-cell-6-3" class="code-annotation-target"><a href="#annotated-cell-6-3"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="3">3</button><span id="annotated-cell-6-4" class="code-annotation-target"><a href="#annotated-cell-6-4"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS Monitoring Location 08282300"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-5"><a href="#annotated-cell-6-5"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS Streamgage at Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="4">4</button><span id="annotated-cell-6-6" class="code-annotation-target"><a href="#annotated-cell-6-6"></a> <span class="dt">"license"</span><span class="fu">:</span> <span class="st">"https://spdx.org/licenses/CC-BY-4.0"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="5">5</button><span id="annotated-cell-6-7" class="code-annotation-target"><a href="#annotated-cell-6-7"></a> <span class="dt">"isAccessibleForFree"</span><span class="fu">:</span> <span class="st">"true"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="6">6</button><span id="annotated-cell-6-8" class="code-annotation-target"><a href="#annotated-cell-6-8"></a> <span class="dt">"variableMeasured"</span><span class="fu">:</span> <span class="fu">{</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="7">7</button><span id="annotated-cell-6-9" class="code-annotation-target"><a href="#annotated-cell-6-9"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-10"><a href="#annotated-cell-6-10"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"discharge"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-11"><a href="#annotated-cell-6-11"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Discharge in cubic feet per second"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="8">8</button><span id="annotated-cell-6-12" class="code-annotation-target"><a href="#annotated-cell-6-12"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"https://www.wikidata.org/wiki/Q8737769"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="9">9</button><span id="annotated-cell-6-13" class="code-annotation-target"><a href="#annotated-cell-6-13"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://en.wikipedia.org/wiki/Discharge_(hydrology)"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="10">10</button><span id="annotated-cell-6-14" class="code-annotation-target"><a href="#annotated-cell-6-14"></a> <span class="dt">"unitText"</span><span class="fu">:</span> <span class="st">"cubic feet per second"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="11">11</button><span id="annotated-cell-6-15" class="code-annotation-target"><a href="#annotated-cell-6-15"></a> <span class="dt">"qudt:hasQuantityKind"</span><span class="fu">:</span> <span class="st">"qudt-quantkinds:VolumeFlowRate"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="12">12</button><span id="annotated-cell-6-16" class="code-annotation-target"><a href="#annotated-cell-6-16"></a> <span class="dt">"unitCodet"</span><span class="fu">:</span> <span class="st">"qudt-units:FT3-PER-SEC"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="13">13</button><span id="annotated-cell-6-17" class="code-annotation-target"><a href="#annotated-cell-6-17"></a> <span class="dt">"measurementTechnique"</span><span class="fu">:</span> <span class="st">"observation"</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="14">14</button><span id="annotated-cell-6-18" class="code-annotation-target"><a href="#annotated-cell-6-18"></a> <span class="dt">"measurementMethod"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="annotated-cell-6-19"><a href="#annotated-cell-6-19"></a> <span class="dt">"name"</span><span class="fu">:</span><span class="st">"Discharge Measurements at Gaging Stations"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-20"><a href="#annotated-cell-6-20"></a> <span class="dt">"publisher"</span><span class="fu">:</span> <span class="st">"U.S. Geological Survey"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-21"><a href="#annotated-cell-6-21"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://doi.org/10.3133/tm3A8"</span></span>
<span id="annotated-cell-6-22"><a href="#annotated-cell-6-22"></a> <span class="fu">}</span></span>
<span id="annotated-cell-6-23"><a href="#annotated-cell-6-23"></a> <span class="fu">},</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="15">15</button><span id="annotated-cell-6-24" class="code-annotation-target"><a href="#annotated-cell-6-24"></a> <span class="dt">"temporalCoverage"</span><span class="fu">:</span> <span class="st">"2014-06-30/.."</span><span class="fu">,</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="16">16</button><span id="annotated-cell-6-25" class="code-annotation-target"><a href="#annotated-cell-6-25"></a> <span class="dt">"ssn-system:frequency"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="annotated-cell-6-26"><a href="#annotated-cell-6-26"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"15"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-27"><a href="#annotated-cell-6-27"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"qudt-units:Minute"</span></span>
<span id="annotated-cell-6-28"><a href="#annotated-cell-6-28"></a> <span class="fu">},</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="17">17</button><span id="annotated-cell-6-29" class="code-annotation-target"><a href="#annotated-cell-6-29"></a> <span class="dt">"distribution"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="annotated-cell-6-30"><a href="#annotated-cell-6-30"></a> <span class="fu">{</span></span>
<span id="annotated-cell-6-31"><a href="#annotated-cell-6-31"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-32"><a href="#annotated-cell-6-32"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"USGS Instantaneous Values Service"</span></span>
<span id="annotated-cell-6-33"><a href="#annotated-cell-6-33"></a> <span class="st">"contentUrl"</span><span class="er">:</span> <span class="st">"https://waterservices.usgs.gov/nwis/iv/?sites=08282300&parameterCd=00060&format=rdb"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-34"><a href="#annotated-cell-6-34"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span><span class="st">"text/tab-separated-values"</span><span class="ot">]</span><span class="fu">,</span></span>
<span id="annotated-cell-6-35"><a href="#annotated-cell-6-35"></a> <span class="dt">"dc:conformsTo"</span><span class="fu">:</span> <span class="st">"https://pubs.usgs.gov/of/2003/ofr03123/6.4rdb_format.pdf"</span></span>
<span id="annotated-cell-6-36"><a href="#annotated-cell-6-36"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="annotated-cell-6-37"><a href="#annotated-cell-6-37"></a> <span class="fu">{</span></span>
<button class="code-annotation-anchor" data-target-cell="annotated-cell-6" data-target-annotation="18">18</button><span id="annotated-cell-6-38" class="code-annotation-target"><a href="#annotated-cell-6-38"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-39"><a href="#annotated-cell-6-39"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"USGS SensorThings API"</span><span class="er">.</span></span>
<span id="annotated-cell-6-40"><a href="#annotated-cell-6-40"></a> <span class="st">"contentUrl"</span><span class="er">:</span> <span class="st">"https://labs.waterdata.usgs.gov/sta/v1.1/Datastreams('0adb31f7852e4e1c9a778a85076ac0cf')?$expand=Thing,Observations"</span><span class="fu">,</span></span>
<span id="annotated-cell-6-41"><a href="#annotated-cell-6-41"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span><span class="st">"application/json"</span><span class="ot">]</span><span class="fu">,</span></span>
<span id="annotated-cell-6-42"><a href="#annotated-cell-6-42"></a> <span class="dt">"dc:conformsTo"</span><span class="fu">:</span> <span class="st">"https://labs.waterdata.usgs.gov/docs/sensorthings/index.html"</span></span>
<span id="annotated-cell-6-43"><a href="#annotated-cell-6-43"></a> <span class="fu">}</span></span>
<span id="annotated-cell-6-44"><a href="#annotated-cell-6-44"></a> <span class="ot">]</span></span>
<span id="annotated-cell-6-45"><a href="#annotated-cell-6-45"></a> <span class="fu">}</span></span>
<span id="annotated-cell-6-46"><a href="#annotated-cell-6-46"></a><span class="fu">}</span></span><div class="code-annotation-gutter-bg"></div><div class="code-annotation-gutter"></div></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<dl class="code-annotation-container-hidden code-annotation-container-grid">
<dt data-target-cell="annotated-cell-6" data-target-annotation="1">1</dt>
<dd>
<span data-code-annotation="1" data-code-cell="annotated-cell-6" data-code-lines="2">This node (we are continuing from the above JSON-LD document, so the USGS Monitoring Location) is <code>subjectOf</code> the node that follows)</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="2">2</dt>
<dd>
<span data-code-annotation="2" data-code-cell="annotated-cell-6" data-code-lines="3">This node is a <code>Dataset</code>(<a href="https://schema.org/Dataset" class="uri">https://schema.org/Dataset</a>)</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="3">3</dt>
<dd>
<span data-code-annotation="3" data-code-cell="annotated-cell-6" data-code-lines="4,5">The dataset’s name and description</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="4">4</dt>
<dd>
<span data-code-annotation="4" data-code-cell="annotated-cell-6" data-code-lines="6">The dataset’s license, which is most easily populated by a URI for the license appropriate for your data. Federal agencies, many state agencies, and academics use open licenses such as those provided by <a href="https://opendatacommons.org/licenses/">opendatacommons.org</a> and <a href="https://creativecommons.org/licenses">creativecommons.org</a>. URIs for licenses are available from <a href="https://spdx.org/licenses/" class="uri">https://spdx.org/licenses/</a></span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="5">5</dt>
<dd>
<span data-code-annotation="5" data-code-cell="annotated-cell-6" data-code-lines="7">Either <code>true</code> or <code>false</code> depending on if the dataset is available for free.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="6">6</dt>
<dd>
<span data-code-annotation="6" data-code-cell="annotated-cell-6" data-code-lines="8">The dataset includes information on a variable. (in schema.org called <a href="https://schema.org/variableMeasured">variableMeasured</a>). Multiple <code>variableMeasured</code> can be specified for datasets by using <a href="https://www.w3.org/TR/json-ld11/#example-135-indexing-language-tagged-strings-and-set">arrays</a>, which is useful for datasets that must be downloaded in bulk that include multiple variables of interest. In general it is more clear to specify a “dataset” per <code>variableMeasured</code> if the data has different temporal coverage per variable, or can be downloaded on a per-variable basis. Multiple <code>variableMeasured</code> can be specified using nested JSON arrays.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="7">7</dt>
<dd>
<span data-code-annotation="7" data-code-cell="annotated-cell-6" data-code-lines="9,10,11"><code>@PropertyValue</code> is a generic type to extend schema.org properties and should just be used as a rule on <code>variableMeasured</code> nodes.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="8">8</dt>
<dd>
<span data-code-annotation="8" data-code-cell="annotated-cell-6" data-code-lines="12"><code>propertyID</code> should be a URI where there is a machine-readable resource defines what the variable is. In this case, we are using a Wikidata link to the concept of stream discharge. In general, a good source for URIs is the <a href="http://vocabulary.odm2.org/variablename/">ODM2 variable vocabulary</a>.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="9">9</dt>
<dd>
<span data-code-annotation="9" data-code-cell="annotated-cell-6" data-code-lines="13">Here <code>url</code> points to a human-readable resource describing the variable, in this case, we are using a Wikipedia link to the concept of stream discharge.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="10">10</dt>
<dd>
<span data-code-annotation="10" data-code-cell="annotated-cell-6" data-code-lines="14">Here we use the units as written in the data source.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="11">11</dt>
<dd>
<span data-code-annotation="11" data-code-cell="annotated-cell-6" data-code-lines="15">While <code>name</code> and <code>propertyID</code> specifies the variable as being “discharge” in this case, since multiple data sources might use different words and identifiers for their variables, it can be useful to reference a more general category of variables that we can ue to group variables across sources. We can use identifiers for <a href="https://qudt.org/schema/qudt/QuantityKind">QuantityKinds</a> from QUDT, which we reference with the <code>qudt-quantkinds</code> for the prefix as described in the <code>@context</code> in <a href="#sec-context">Section 1.3.1</a>.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="12">12</dt>
<dd>
<span data-code-annotation="12" data-code-cell="annotated-cell-6" data-code-lines="16">While <code>unitText</code> above specifies the units, since multiple data sources might use different words for the same unit, to improve interoperability we can use identifiers for units provided by QUDT, which we reference with the <code>qudt-units</code> vocabulary prefix as described in the <code>@context</code> in <a href="#sec-context">Section 1.3.1</a>. If units from QUDT are unavailable, first check if <code>unitText</code> can be filled with a term from name from http://vocabulary.odm2.org/units/.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="13">13</dt>
<dd>
<span data-code-annotation="13" data-code-cell="annotated-cell-6" data-code-lines="17"><code>measurementTechnique</code> is meant to be a highly general account of the data generating procedure, and primarily to distinguish between observed and modeled data. It is highly recommended for this to be <code>model</code> or <code>observation</code>, or if more specificity is required, to restrict these values to the ODM2 <a href="http://vocabulary.odm2.org/methodtype/">methodType</a> vocabulary.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="14">14</dt>
<dd>
<span data-code-annotation="14" data-code-cell="annotated-cell-6" data-code-lines="18,19,20,21,22,23"><code>measurementMethod</code> specifies the method used to generate the data to as great a degree of specificity as possible. Ideally it could a persistent identifier that directs to a machine-readable web resource that unambiguously describes that method. This would look something like this: <code>"measurementMethod": {"@id": "https://www.nemi.gov/methods/method_summary/4680/"}</code> In lieu of that, a name, description and URL to human-readable web resource like an explanatory webpage, technical report, standards document, or academic article would be appropriate, as in this example for USGS discharge measurement.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="15">15</dt>
<dd>
<span data-code-annotation="15" data-code-cell="annotated-cell-6" data-code-lines="24"><code>temporal coverage</code> refers to the first and last time for which data is available. It can be specified using <a href="https://en.wikipedia.org/wiki/ISO_8601#Time_intervals">ISO 8061 interval format</a> (<code>YYYY-MM-DD/YYYY-MM-DD</code>, with the start date first and the end date after the <code>/</code> . It can also include time like so <code>YYYY-MM-DDTHH:MM:SS/YYYY-MM-DDTHH:MM:SS</code> . If the dataset has no end date, as there is an active monitoring program, then this can be indicated like so <code>YYYY-MM-DD/..</code> .</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="16">16</dt>
<dd>
<span data-code-annotation="16" data-code-cell="annotated-cell-6" data-code-lines="25,26,27"><code>ssn-system:frequency</code> refers to the minimum intended time spacing between observations in the case of regular time series data. Irregular time series or discrete sample data should omit this block. The <code>value</code> should be an integer and the <code>unitCode</code> a time unit from <code>qudt-units</code>.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="17">17</dt>
<dd>
<span data-code-annotation="17" data-code-cell="annotated-cell-6" data-code-lines="29,31,32,33,34,35"><code>distribution</code> provides a way to structure information about data access points. This can range in complexity from a specification of a URL and format to specifications for how to interact with an API. In this example, a URL, format (<code>encodingFormat</code> populated by <a href="https://www.iana.org/assignments/media-types/media-types.xhtml">MIME type</a>). <code>conformsTo</code> is optional and should be a document that helps interpret the data structure. This could be a link to a data dictionary in the case of simple tabular data, documentation of a data model for a complex database, or an API specification document for an API endpoint.</span>
</dd>
<dt data-target-cell="annotated-cell-6" data-target-annotation="18">18</dt>
<dd>
<span data-code-annotation="18" data-code-cell="annotated-cell-6" data-code-lines="38,39,40,41,42">Multiple <code>distributions</code> can be specified using nested JSON arrays.</span>
</dd>
</dl>
<p>This translates roughly to</p>
<ul>
<li><p>There is is the following information about me: a <code>Dataset</code></p>
<ul>
<li><p>for the variable (<code>measuredVariable</code>) <code>Discharge</code></p>
<ul>
<li><p>It has values between <code>June 6, 2014</code> to the <code>present</code></p></li>
<li><p>at a <code>15</code> <code>minute</code> time resolution</p></li>
<li><p>in units of <code>cubic feet per second</code></p></li>
<li><p>generated by <code>location observation</code></p></li>
<li><p>generated in particular using <a href="https://pubs.usgs.gov/publication/tm3A8">USGS discharge measurement methods</a>.</p></li>
<li><p>You can download it:</p>
<ul>
<li><p><a href="https://waterservices.usgs.gov/nwis/iv/?sites=08282300&paramete">here</a></p>
<ul>
<li><p>Using the <a href="https://waterservices.usgs.gov/rest/IV-Service.html">USGS Instantaneous Values REST Web Service</a></p></li>
<li><p>in the <a href="https://waterdata.usgs.gov/nwis/?tab_delimited_format_info">RDB format</a></p></li>
</ul></li>
<li><p>You can also download it <a href="https://labs.waterdata.usgs.gov/sta/v1.1/Datastreams('0adb31f7852e4e1c9a778a85076ac0cf')?$expand=Thing,Observations">here</a></p>
<ul>
<li><p>Using the <a href="https://labs.waterdata.usgs.gov/docs/sensorthings/index.html">USGS SensorThings API implementation</a></p></li>
<li><p>in JSON</p></li>
</ul></li>
</ul></li>
</ul></li>
</ul></li>
</ul>
</section>
</section>
</section>
<section id="sec-data" class="level3" data-number="2.1.2">
<h3 data-number="2.1.2" class="anchored" data-anchor-id="sec-data"><span class="header-section-number">2.1.2</span> Dataset-oriented</h3>
<p>The purpose of the dataset-oriented page is to give enough information about the data available and the area, locations, or features that it is relevant to that a water data user would be able to quickly determine whether and how to download the data after reading. We will use this <a href="https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299/">data resource about water utility treated water demand that has been published at HydroShare</a> as an example for the type of content to put in dataset-oriented Geoconnex landing page web resources and how to map that content to embedded JSON-LD documents.</p>
<div class="callout callout-style-default callout-note callout-titled">
<div class="callout-header d-flex align-content-center">
<div class="callout-icon-container">
<i class="callout-icon"></i>
</div>
<div class="callout-title-container flex-fill">
Note
</div>
</div>
<div class="callout-body-container callout-body">
<p>Scroll up and down to view elements of the example landing page</p>
</div>
</div>
<iframe width="780" height="500" src="https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299/" title="Hydroshare Example"></iframe>
<p>This dataset-oriented web resource includes this type of information</p>
<ul>
<li><p>“This is my URI (which is a DOI-URL): https://geoconnex.us/ref/monitoring-location/08282300”<a href="#fn13" class="footnote-ref" id="fnref13" role="doc-noteref"><sup>13</sup></a></p></li>
<li><p>“This is my permanent identifier, which is a DOI”: <a href="#fn14" class="footnote-ref" id="fnref14" role="doc-noteref"><sup>14</sup></a></p></li>
<li><p>“This is my URL <a href="https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299" class="uri">https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299</a>”<a href="#fn15" class="footnote-ref" id="fnref15" role="doc-noteref"><sup>15</sup></a></p></li>
<li><p>“My creator is <name>”</name></p></li>
<li><p>“I am provided by HydroShare”</p></li>
<li><p>“My spatial coverage is the bounding box <code>"35.5463 -79.1235 36.0520 -78.3765"</code>”<a href="#fn16" class="footnote-ref" id="fnref16" role="doc-noteref"><sup>16</sup></a></p></li>
<li><p>“I have data between January 1, 2002 and December 31, 2020” <a href="#fn17" class="footnote-ref" id="fnref17" role="doc-noteref"><sup>17</sup></a></p></li>
<li><p>“My data is at a <code>1</code> <code>month</code> time step frequency” <a href="#fn18" class="footnote-ref" id="fnref18" role="doc-noteref"><sup>18</sup></a></p></li>
<li><p>“I am about the following features”:<a href="#fn19" class="footnote-ref" id="fnref19" role="doc-noteref"><sup>19</sup></a>.</p>
<ul>
<li><a href="https://geoconnex.us/ref/pws/NC0392010">Raleigh Public Water System</a></li>
<li><a href="https://geoconnex.us/ref/pws/NC0392020">Cary Public Water System</a></li>
<li><a href="https://geoconnex.us/ref/pws/NC0332010">Durham Public Water System</a></li>
<li><a href="https://geoconnex.us/ref/pws/NC0392045">Apex Public Water System</a></li>
<li><a href="https://geoconnex.us/ref/pws/NC0368010">Orange Water and Sewer Authority</a></li>
</ul></li>
<li><p>“I have the following variables”:</p>
<ul>
<li>Monthly Water demand measured in units of averaged millions of gallons per day</li>
<li>Historic Mean monthly water demand over the period of record measured in units of millions of gallons per day</li>
<li>The monthly water demand divided by historic mean monthly water demand, as a percent</li>
</ul></li>
<li><p>“You can download me <a href="https://www.hydroshare.org/hsapi/resource/4cf2a4298eca418f980201c1c5505299/">here</a> on HydroShare as a zipped csv file”</p></li>
<li><p>“I am accessible for free subject to this <a href="http://creativecommons.org/licenses/by/4.0/">license</a>.</p></li>
</ul>
<section id="json-ld-1" class="level4" data-number="2.1.2.1">
<h4 data-number="2.1.2.1" class="anchored" data-anchor-id="json-ld-1"><span class="header-section-number">2.1.2.1</span> JSON-LD</h4>
<p>Much is similar to the <a href="#sec-loc-data">Datasets guidance for location-oriented web resources</a>, so here we focus on the differences. Note that HydroShare automatically embeds JSON-LD. The JSON-LD examples below vary somewhat from HydroShare’s default content to illustrate optional elements that would be useful for Geoconnex that are not currently implemented in HydroShare.</p>
<section id="identifiers-provenance-license-and-distribution." class="level5" data-number="2.1.2.1.1">
<h5 data-number="2.1.2.1.1" class="anchored" data-anchor-id="identifiers-provenance-license-and-distribution."><span class="header-section-number">2.1.2.1.1</span> Identifiers, provenance, license, and distribution.</h5>
<p>For basic identifying and descriptive information, <a href="https://github.com/ESIPFed/science-on-schema.org/blob/master/examples/dataset/minimal.jsonld">science-on-schema.org has appropriate guidance</a>. In this case, note that a specific file download URL has been provided rather than an API endpoint, and that <code>dc:conformsTo</code> points to a data dictionary that is supplied at the same web resource.</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb8-1"><a href="#cb8-1"></a><span class="fu">{</span></span>
<span id="cb8-2"><a href="#cb8-2"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb8-3"><a href="#cb8-3"></a> <span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"https://schema.org/"</span><span class="fu">,</span> </span>
<span id="cb8-4"><a href="#cb8-4"></a> <span class="dt">"rdfs"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/2000/01/rdf-schema#"</span><span class="fu">,</span></span>
<span id="cb8-5"><a href="#cb8-5"></a> <span class="dt">"dc"</span><span class="fu">:</span> <span class="st">"http://purl.org/dc/terms/"</span><span class="fu">,</span></span>
<span id="cb8-6"><a href="#cb8-6"></a> <span class="dt">"qudt"</span><span class="fu">:</span> <span class="st">"http://qudt.org/schema/qudt/"</span><span class="fu">,</span></span>
<span id="cb8-7"><a href="#cb8-7"></a> <span class="dt">"qudt-units"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/unit/"</span><span class="fu">,</span></span>
<span id="cb8-8"><a href="#cb8-8"></a> <span class="dt">"qudt-quantkinds"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/quantitykind/"</span><span class="fu">,</span></span>
<span id="cb8-9"><a href="#cb8-9"></a> <span class="dt">"gsp"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#"</span><span class="fu">,</span></span>
<span id="cb8-10"><a href="#cb8-10"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype"</span><span class="fu">,</span></span>
<span id="cb8-11"><a href="#cb8-11"></a> <span class="dt">"odm2var"</span><span class="fu">:</span><span class="st">"http://vocabulary.odm2.org/variablename/"</span><span class="fu">,</span></span>
<span id="cb8-12"><a href="#cb8-12"></a> <span class="dt">"odm2varType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variabletype/"</span><span class="fu">,</span></span>
<span id="cb8-13"><a href="#cb8-13"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb8-14"><a href="#cb8-14"></a> <span class="dt">"skos"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType"</span><span class="fu">,</span></span>
<span id="cb8-15"><a href="#cb8-15"></a> <span class="dt">"ssn"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/"</span><span class="fu">,</span></span>
<span id="cb8-16"><a href="#cb8-16"></a> <span class="dt">"ssn-system"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/systems/"</span></span>
<span id="cb8-17"><a href="#cb8-17"></a> <span class="fu">},</span></span>
<span id="cb8-18"><a href="#cb8-18"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<span id="cb8-19"><a href="#cb8-19"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://doi.org/10.4211/hs.4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb8-20"><a href="#cb8-20"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="st">"doi:hs.4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb8-21"><a href="#cb8-21"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Geoconnex Dataset Example: Data for Triangle Water Supply Dashboard"</span><span class="fu">,</span></span>
<span id="cb8-22"><a href="#cb8-22"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"This is a dataset meant as an example of dataset-level schema.org markup for https://geoconnex.us. It uses as an example data from the NC Triangle Water Supply Dashboard, which collects and visualizes finished water deliveries by water utilities to their service areas in the North Carolina Research Triangle area"</span><span class="fu">,</span></span>
<span id="cb8-23"><a href="#cb8-23"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb8-24"><a href="#cb8-24"></a> <span class="dt">"keywords"</span><span class="fu">:</span> <span class="ot">[</span><span class="st">"water demand"</span><span class="ot">,</span> <span class="st">"water supply"</span><span class="ot">,</span> <span class="st">"geoconnex"</span><span class="ot">]</span><span class="fu">,</span></span>
<span id="cb8-25"><a href="#cb8-25"></a> <span class="dt">"license"</span><span class="fu">:</span> <span class="st">"https://creativecommons.org/licenses/by/4.0/"</span><span class="fu">,</span></span>
<span id="cb8-26"><a href="#cb8-26"></a> <span class="dt">"isAccessibleForFree"</span><span class="fu">:</span> <span class="st">"true"</span><span class="fu">,</span></span>
<span id="cb8-27"><a href="#cb8-27"></a> <span class="dt">"distribution"</span><span class="fu">:</span> <span class="ot">[</span> </span>
<span id="cb8-28"><a href="#cb8-28"></a> <span class="fu">{</span></span>
<span id="cb8-29"><a href="#cb8-29"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span> </span>
<span id="cb8-30"><a href="#cb8-30"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"HydroShare file URL"</span> </span>
<span id="cb8-31"><a href="#cb8-31"></a> <span class="st">"contentUrl"</span><span class="er">:</span> <span class="st">"https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299/data/contents/demand_over_time.csv"</span><span class="fu">,</span> </span>
<span id="cb8-32"><a href="#cb8-32"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span><span class="st">"text/csv"</span><span class="ot">]</span><span class="fu">,</span> </span>
<span id="cb8-33"><a href="#cb8-33"></a> <span class="dt">"dc:conformsTo"</span><span class="fu">:</span> <span class="st">"https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299/data/contents/dataDictionary.xlsx"</span> </span>
<span id="cb8-34"><a href="#cb8-34"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb8-35"><a href="#cb8-35"></a> <span class="er">...</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</section>
<section id="variables-and-methods" class="level5" data-number="2.1.2.1.2">
<h5 data-number="2.1.2.1.2" class="anchored" data-anchor-id="variables-and-methods"><span class="header-section-number">2.1.2.1.2</span> Variables and Methods</h5>
<p>Again, follows the <a href="#sec-loc-data">dataset guidance</a>. In the example below, multiple <code>variableMeasured</code> are specified using a nested array. Other differences to point out:</p>
<ul>
<li>The unit of “million gallons per day” is not available from the QUDT units vocabulary. It is in the <a href="http://vocabulary.odm2.org/units/">ODM2 units codelist</a>, so we populate <code>unitCode</code> with the url listed there.</li>
<li>The measurementMethod for both variables, which are simply different aggregation statistics for the same variable, do not have known web resources or specific identifiers available, and so use <code>description</code> to clarify the method.</li>
</ul>
<div class="sourceCode" id="cb9"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb9-1"><a href="#cb9-1"></a><span class="er">...,</span></span>
<span id="cb9-2"><a href="#cb9-2"></a> <span class="er">"variableMeasured":</span> <span class="ot">[</span></span>
<span id="cb9-3"><a href="#cb9-3"></a> <span class="fu">{</span> </span>
<span id="cb9-4"><a href="#cb9-4"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span> </span>
<span id="cb9-5"><a href="#cb9-5"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"water demand"</span><span class="fu">,</span> </span>
<span id="cb9-6"><a href="#cb9-6"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"treated water delivered to distribution system"</span><span class="fu">,</span> </span>
<span id="cb9-7"><a href="#cb9-7"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variablename/waterUsePublicSupply/"</span><span class="fu">,</span> </span>
<span id="cb9-8"><a href="#cb9-8"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variablename/waterUsePublicSupply/"</span><span class="fu">,</span> </span>
<span id="cb9-9"><a href="#cb9-9"></a> <span class="dt">"unitText"</span><span class="fu">:</span> <span class="st">"million gallons per day"</span><span class="fu">,</span></span>
<span id="cb9-10"><a href="#cb9-10"></a> <span class="dt">"qudt:hasQuantityKind"</span><span class="fu">:</span> <span class="st">"qudt-quantkinds:VolumeFlowRate"</span><span class="fu">,</span> </span>
<span id="cb9-11"><a href="#cb9-11"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"http://his.cuahsi.org/mastercvreg/edit_cv11.aspx?tbl=Units&id=1125579048"</span><span class="fu">,</span> </span>
<span id="cb9-12"><a href="#cb9-12"></a> <span class="dt">"measurementTechnique"</span><span class="fu">:</span> <span class="st">"observation"</span><span class="fu">,</span> </span>
<span id="cb9-13"><a href="#cb9-13"></a> <span class="dt">"measurementMethod"</span><span class="fu">:</span> <span class="fu">{</span> </span>
<span id="cb9-14"><a href="#cb9-14"></a> <span class="dt">"name"</span><span class="fu">:</span><span class="st">"water meter"</span><span class="fu">,</span></span>
<span id="cb9-15"><a href="#cb9-15"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"metered bulk value, accumlated over one month"</span><span class="fu">,</span></span>
<span id="cb9-16"><a href="#cb9-16"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://www.wikidata.org/wiki/Q268503"</span> </span>
<span id="cb9-17"><a href="#cb9-17"></a> <span class="fu">}</span> </span>
<span id="cb9-18"><a href="#cb9-18"></a> <span class="fu">}</span><span class="ot">,</span> </span>
<span id="cb9-19"><a href="#cb9-19"></a> <span class="fu">{</span> </span>
<span id="cb9-20"><a href="#cb9-20"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span> </span>
<span id="cb9-21"><a href="#cb9-21"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"water demand (monthly average)"</span><span class="fu">,</span> </span>
<span id="cb9-22"><a href="#cb9-22"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"average monthly treated water delivered to distribution system"</span><span class="fu">,</span> </span>
<span id="cb9-23"><a href="#cb9-23"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variablename/waterUsePublicSupply/"</span><span class="fu">,</span> </span>
<span id="cb9-24"><a href="#cb9-24"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variablename/waterUsePublicSupply/"</span><span class="fu">,</span> </span>
<span id="cb9-25"><a href="#cb9-25"></a> <span class="dt">"unitText"</span><span class="fu">:</span> <span class="st">"million gallons per day"</span><span class="fu">,</span> </span>
<span id="cb9-26"><a href="#cb9-26"></a> <span class="dt">"qudt:hasQuantityKind"</span><span class="fu">:</span> <span class="st">"qudt-quantkinds:VolumeFlowRate"</span><span class="fu">,</span> </span>
<span id="cb9-27"><a href="#cb9-27"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"http://his.cuahsi.org/mastercvreg/edit_cv11.aspx?tbl=Units&id=1125579048"</span><span class="fu">,</span> </span>
<span id="cb9-28"><a href="#cb9-28"></a> <span class="dt">"measurementTechnique"</span><span class="fu">:</span> <span class="st">"observation"</span><span class="fu">,</span> </span>
<span id="cb9-29"><a href="#cb9-29"></a> <span class="dt">"measurementMethod"</span><span class="fu">:</span> <span class="fu">{</span> </span>
<span id="cb9-30"><a href="#cb9-30"></a> <span class="dt">"name"</span><span class="fu">:</span><span class="st">"water meter"</span><span class="fu">,</span> </span>
<span id="cb9-31"><a href="#cb9-31"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"metered bulk value, average accumlated over each month for multiple years"</span><span class="fu">,</span> </span>
<span id="cb9-32"><a href="#cb9-32"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://www.wikidata.org/wiki/Q268503"</span> </span>
<span id="cb9-33"><a href="#cb9-33"></a> <span class="fu">}</span> </span>
<span id="cb9-34"><a href="#cb9-34"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb9-35"><a href="#cb9-35"></a> <span class="ot">]</span><span class="er">,</span></span>
<span id="cb9-36"><a href="#cb9-36"></a> <span class="er">"temporalCoverage":</span> <span class="er">"2002-01-01/2020-12-31",</span> </span>
<span id="cb9-37"><a href="#cb9-37"></a> <span class="er">"ssn-system:frequency":</span> <span class="fu">{</span> </span>
<span id="cb9-38"><a href="#cb9-38"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"1"</span><span class="fu">,</span> </span>
<span id="cb9-39"><a href="#cb9-39"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"qudt-units:Month"</span> </span>
<span id="cb9-40"><a href="#cb9-40"></a> <span class="fu">}</span><span class="er">,</span></span>
<span id="cb9-41"><a href="#cb9-41"></a> </span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</section>
<section id="geoconnex-reference-feature-links-and-spatial-coverage" class="level5" data-number="2.1.2.1.3">
<h5 data-number="2.1.2.1.3" class="anchored" data-anchor-id="geoconnex-reference-feature-links-and-spatial-coverage"><span class="header-section-number">2.1.2.1.3</span> Geoconnex Reference Feature Links and Spatial Coverage</h5>
<p>Unlike the location-based example, where a location is explicitly the <code>subjectOf</code> the dataset, here, the dataset must be described as being <code>about</code> certain features. If the dataset is not explicitly about any discrete features, such as raster datasets, then a Spatial Coverage should be specified.</p>
<p>Using the <code>about</code> construction, a single geoconnex URI or an array of multiple can be constructed. In the below example, multiple are used. Note the nesting of nodes within the array so that each URI has an <code>@id</code> keyword and is <code>@type</code> <code>Place</code>. In this example, URIs from the geoconnex <a href="https://reference.geoconnex.us/collections/pws">reference features set for Public Water Systems</a> are used.</p>
<div class="sourceCode" id="cb10"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb10-1"><a href="#cb10-1"></a><span class="er">...,</span></span>
<span id="cb10-2"><a href="#cb10-2"></a><span class="er">"about":</span> <span class="ot">[</span></span>
<span id="cb10-3"><a href="#cb10-3"></a> <span class="fu">{</span></span>
<span id="cb10-4"><a href="#cb10-4"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/pws/NC0332010"</span><span class="fu">,</span></span>
<span id="cb10-5"><a href="#cb10-5"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span></span>
<span id="cb10-6"><a href="#cb10-6"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb10-7"><a href="#cb10-7"></a> </span>
<span id="cb10-8"><a href="#cb10-8"></a> <span class="fu">{</span></span>
<span id="cb10-9"><a href="#cb10-9"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/pws/NC0368010"</span><span class="fu">,</span></span>
<span id="cb10-10"><a href="#cb10-10"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span></span>
<span id="cb10-11"><a href="#cb10-11"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb10-12"><a href="#cb10-12"></a> </span>
<span id="cb10-13"><a href="#cb10-13"></a> <span class="fu">{</span></span>
<span id="cb10-14"><a href="#cb10-14"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/pws/NC0392010"</span><span class="fu">,</span></span>
<span id="cb10-15"><a href="#cb10-15"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span></span>
<span id="cb10-16"><a href="#cb10-16"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb10-17"><a href="#cb10-17"></a> </span>
<span id="cb10-18"><a href="#cb10-18"></a> <span class="fu">{</span></span>
<span id="cb10-19"><a href="#cb10-19"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/pws/NC0392020"</span><span class="fu">,</span></span>
<span id="cb10-20"><a href="#cb10-20"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span></span>
<span id="cb10-21"><a href="#cb10-21"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb10-22"><a href="#cb10-22"></a> <span class="fu">{</span></span>
<span id="cb10-23"><a href="#cb10-23"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/pws/NC0392045"</span><span class="fu">,</span></span>
<span id="cb10-24"><a href="#cb10-24"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span></span>
<span id="cb10-25"><a href="#cb10-25"></a> <span class="fu">}</span></span>
<span id="cb10-26"><a href="#cb10-26"></a> <span class="ot">]</span><span class="er">,</span></span>
<span id="cb10-27"><a href="#cb10-27"></a> <span class="er">...</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>To assist in finding reference features, <a href="https://reference.geoconnex.us" class="uri">https://reference.geoconnex.us</a> allows queries following the <a href="https://ogcapi.ogc.org/features/">OGC-API Features</a> API standard and the CQL <a href="https://portal.ogc.org/files/96288">Common Query Language standard</a>.</p>
<p>For example, to find the Geoconnex URI for the Raleigh public water system (PWS), we can construct the URL:</p>
<ul>
<li>CQL filter API endpoint for the PWS feature collection <a href="https://reference.geoconnex.us/collections/pws/items" class="uri">https://reference.geoconnex.us/collections/pws/items</a></li>
<li>filter for name field <code>pws_name</code>: <a href="https://reference.geoconnex.us/collections/pws/items?filter=pws_name" class="uri">https://reference.geoconnex.us/collections/pws/items?filter=pws_name</a></li>
<li>filter for a name that includes “Raleigh”: <a href="https://reference.geoconnex.us/collections/pws/items?filter=pws_name%20ILIKE" title="%Raleigh%">https://reference.geoconnex.us/collections/pws/items?filter=pws_name ILIKE ‘%Raleigh%’</a></li>
</ul>
<p>Sometimes it is impossible to use feature URIs because the relevant specific features are not available from <a href="https://reference.geoconnex.us/collections" class="uri">https://reference.geoconnex.us/collections</a>. If so, feel free to <a href="https://github.com/internetofwater/geoconnex.us/issues/new/choose">submit an issue to the geoconnex.us github repository</a> requesting a reference feature set.</p>
<p>Sometimes it is impractical to list all applicable reference features, whether or not they are in <a href="https://reference.geoconnex.us" class="uri">https://reference.geoconnex.us</a> or another source. This is common for comprehensive datasets that are all about an entire reference dataset or other another dataset like a hydrofabric, such as datasets summmarizing values to U.S. Counties, or the National Water Model generating values for all NHDPlusV2 COMID flowlines. In this case it is best to declare that the Dataset is <a href="https://schema.org/isBasedOn">isBasedOn</a> the source geospatial fabric. For example, if the example dataset were about all public water systems instead of just the 5 listed, instead of <code>about</code>, we should specify an identifier, name, description, and any URLs for other resources that describe the source fabric and how to interpret it:</p>
<div class="sourceCode" id="cb11"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb11-1"><a href="#cb11-1"></a><span class="er">...,</span></span>
<span id="cb11-2"><a href="#cb11-2"></a><span class="er">"isBasedOn":</span> <span class="fu">{</span></span>
<span id="cb11-3"><a href="#cb11-3"></a><span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://www.hydroshare.org/resource/9ebc0a0b43b843b9835830ffffdd971e/"</span><span class="fu">,</span></span>
<span id="cb11-4"><a href="#cb11-4"></a><span class="dt">"name"</span><span class="fu">:</span> <span class="st">"U.S. Community Water Systems Service Boundaries, v4.0.0"</span></span>
<span id="cb11-5"><a href="#cb11-5"></a><span class="st">"description"</span><span class="er">:</span> <span class="st">"This is a layer of water service boundaries for 45,973 community water systems that deliver tap water to 307.7 million people in the US."</span> </span>
<span id="cb11-6"><a href="#cb11-6"></a><span class="st">"url"</span><span class="er">:</span> <span class="st">"https://github.com/SimpleLab-Inc/wsb"</span></span>
<span id="cb11-7"><a href="#cb11-7"></a><span class="fu">}</span><span class="er">,</span></span>
<span id="cb11-8"><a href="#cb11-8"></a><span class="er">...</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Sometimes there are no particular features that a dataset is explicitly about. This is common with remote sensing raster data. In this case, it is best to specify a <code>spatialCoverage</code> polygon using WKT encoded geometry:</p>
<div class="sourceCode" id="cb12"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb12-1"><a href="#cb12-1"></a> <span class="er">"spatialCoverage":</span> <span class="fu">{</span></span>
<span id="cb12-2"><a href="#cb12-2"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Place"</span><span class="fu">,</span></span>
<span id="cb12-3"><a href="#cb12-3"></a> <span class="dt">"gsp:hasGeometry"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb12-4"><a href="#cb12-4"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/sf#MultiPolygon"</span><span class="fu">,</span></span>
<span id="cb12-5"><a href="#cb12-5"></a> <span class="dt">"gsp:asWKT"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb12-6"><a href="#cb12-6"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#wktLiteral"</span><span class="fu">,</span></span>
<span id="cb12-7"><a href="#cb12-7"></a> <span class="dt">"@value"</span><span class="fu">:</span> <span class="st">"MULTIPOLYGON (((-85.67957299999999 32.799514, -85.679637 32.822002999999995, -85.67199699999999 32.822063, -85.66421 32.821711, -85.647989 32.82224, -85.627966 32.822331, -85.627781 32.800716, -85.627496 32.778602, -85.635931 32.778656999999995, -85.645034 32.778146, -85.653352 32.778481, -85.67933699999999 32.778239, -85.67936399999999 32.784064, -85.679808 32.792068, -85.67957299999999 32.799514)))"</span></span>
<span id="cb12-8"><a href="#cb12-8"></a> <span class="fu">}</span></span>
<span id="cb12-9"><a href="#cb12-9"></a> <span class="fu">}</span></span>
<span id="cb12-10"><a href="#cb12-10"></a> <span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</section>
</section>
</section>
</section>
<section id="sec-complete-examples" class="level2" data-number="2.2">
<h2 data-number="2.2" class="anchored" data-anchor-id="sec-complete-examples"><span class="header-section-number">2.2</span> Complete Examples</h2>
<p>Below are complete examples for the general JSON-LD document types depending on the location or dataset orientation and data type.</p>
<p>They are viewable together below, or available for download:</p>
<ul>
<li><a href="https://raw.githubusercontent.com/internetofwater/geoconnex-guidance/main/examples/location-complete.jsonld">location-oriented example</a></li>
<li><a href="https://raw.githubusercontent.com/internetofwater/geoconnex-guidance/main/examples/dataaset-complete.jsonld">dataset-oriented example</a></li>
</ul>
<section id="sec-loc-complete-example" class="level3" data-number="2.2.1">
<h3 data-number="2.2.1" class="anchored" data-anchor-id="sec-loc-complete-example"><span class="header-section-number">2.2.1</span> Location-oriented</h3>
<div class="sourceCode" id="cb13"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb13-1"><a href="#cb13-1"></a><span class="fu">{</span></span>
<span id="cb13-2"><a href="#cb13-2"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-3"><a href="#cb13-3"></a> <span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"https://schema.org/"</span><span class="fu">,</span> </span>
<span id="cb13-4"><a href="#cb13-4"></a> <span class="dt">"rdfs"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/2000/01/rdf-schema#"</span><span class="fu">,</span></span>
<span id="cb13-5"><a href="#cb13-5"></a> <span class="dt">"dc"</span><span class="fu">:</span> <span class="st">"http://purl.org/dc/terms/"</span><span class="fu">,</span></span>
<span id="cb13-6"><a href="#cb13-6"></a> <span class="dt">"qudt"</span><span class="fu">:</span> <span class="st">"http://qudt.org/schema/qudt/"</span><span class="fu">,</span></span>
<span id="cb13-7"><a href="#cb13-7"></a> <span class="dt">"qudt-units"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/unit/"</span><span class="fu">,</span></span>
<span id="cb13-8"><a href="#cb13-8"></a> <span class="dt">"qudt-quantkinds"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/quantitykind/"</span><span class="fu">,</span></span>
<span id="cb13-9"><a href="#cb13-9"></a> <span class="dt">"gsp"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#"</span><span class="fu">,</span></span>
<span id="cb13-10"><a href="#cb13-10"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype"</span><span class="fu">,</span></span>
<span id="cb13-11"><a href="#cb13-11"></a> <span class="dt">"odm2var"</span><span class="fu">:</span><span class="st">"http://vocabulary.odm2.org/variablename/"</span><span class="fu">,</span></span>
<span id="cb13-12"><a href="#cb13-12"></a> <span class="dt">"odm2varType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variabletype/"</span><span class="fu">,</span></span>
<span id="cb13-13"><a href="#cb13-13"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb13-14"><a href="#cb13-14"></a> <span class="dt">"skos"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType"</span><span class="fu">,</span></span>
<span id="cb13-15"><a href="#cb13-15"></a> <span class="dt">"ssn"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/"</span><span class="fu">,</span></span>
<span id="cb13-16"><a href="#cb13-16"></a> <span class="dt">"ssn-system"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/systems/"</span></span>
<span id="cb13-17"><a href="#cb13-17"></a> <span class="fu">},</span></span>
<span id="cb13-18"><a href="#cb13-18"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/usgs/monitoring-location/08282300"</span><span class="fu">,</span></span>
<span id="cb13-19"><a href="#cb13-19"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb13-20"><a href="#cb13-20"></a> <span class="st">"hyf:HY_HydrometricFeature"</span><span class="ot">,</span></span>
<span id="cb13-21"><a href="#cb13-21"></a> <span class="st">"hyf:HY_HydroLocation"</span><span class="ot">,</span></span>
<span id="cb13-22"><a href="#cb13-22"></a> <span class="st">"locType:stream"</span></span>
<span id="cb13-23"><a href="#cb13-23"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb13-24"><a href="#cb13-24"></a> <span class="dt">"hyf:HydroLocationType"</span><span class="fu">:</span> <span class="st">"hydrometric station"</span><span class="fu">,</span></span>
<span id="cb13-25"><a href="#cb13-25"></a> <span class="dt">"sameAs"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-26"><a href="#cb13-26"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/gages/1018463"</span></span>
<span id="cb13-27"><a href="#cb13-27"></a> <span class="fu">},</span></span>
<span id="cb13-28"><a href="#cb13-28"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-29"><a href="#cb13-29"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="cb13-30"><a href="#cb13-30"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"USGS site number"</span><span class="fu">,</span></span>
<span id="cb13-31"><a href="#cb13-31"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"08282300"</span></span>
<span id="cb13-32"><a href="#cb13-32"></a> <span class="fu">},</span></span>
<span id="cb13-33"><a href="#cb13-33"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<span id="cb13-34"><a href="#cb13-34"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Stream/River Site"</span><span class="fu">,</span></span>
<span id="cb13-35"><a href="#cb13-35"></a> <span class="dt">"provider"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-36"><a href="#cb13-36"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://waterdata.usgs.gov"</span><span class="fu">,</span></span>
<span id="cb13-37"><a href="#cb13-37"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"GovernmentOrganization"</span><span class="fu">,</span></span>
<span id="cb13-38"><a href="#cb13-38"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"U.S. Geological Survey Water Data for the Nation"</span></span>
<span id="cb13-39"><a href="#cb13-39"></a> <span class="fu">},</span></span>
<span id="cb13-40"><a href="#cb13-40"></a> <span class="dt">"geo"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-41"><a href="#cb13-41"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"schema:GeoCoordinates"</span><span class="fu">,</span></span>
<span id="cb13-42"><a href="#cb13-42"></a> <span class="dt">"longitude"</span><span class="fu">:</span> <span class="fl">-106.4707722</span><span class="fu">,</span></span>
<span id="cb13-43"><a href="#cb13-43"></a> <span class="dt">"latitude"</span><span class="fu">:</span> <span class="fl">36.7379333</span></span>
<span id="cb13-44"><a href="#cb13-44"></a> <span class="fu">},</span></span>
<span id="cb13-45"><a href="#cb13-45"></a> <span class="dt">"gsp:hasGeometry"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-46"><a href="#cb13-46"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/sf#Point"</span><span class="fu">,</span></span>
<span id="cb13-47"><a href="#cb13-47"></a> <span class="dt">"gsp:asWKT"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-48"><a href="#cb13-48"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#wktLiteral"</span><span class="fu">,</span></span>
<span id="cb13-49"><a href="#cb13-49"></a> <span class="dt">"@value"</span><span class="fu">:</span> <span class="st">"POINT (-106.4707722 36.7379333)"</span></span>
<span id="cb13-50"><a href="#cb13-50"></a> <span class="fu">},</span></span>
<span id="cb13-51"><a href="#cb13-51"></a> <span class="dt">"gsp:crs"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-52"><a href="#cb13-52"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/def/crs/OGC/1.3/CRS84"</span></span>
<span id="cb13-53"><a href="#cb13-53"></a> <span class="fu">}</span></span>
<span id="cb13-54"><a href="#cb13-54"></a> <span class="fu">},</span></span>
<span id="cb13-55"><a href="#cb13-55"></a> <span class="dt">"hyf:referencedPosition"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-56"><a href="#cb13-56"></a> <span class="dt">"hyf:HY_IndirectPosition"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-57"><a href="#cb13-57"></a> <span class="dt">"hyf:linearElement"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-58"><a href="#cb13-58"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://geoconnex.us/ref/mainstems/1611418"</span></span>
<span id="cb13-59"><a href="#cb13-59"></a> <span class="fu">}</span></span>
<span id="cb13-60"><a href="#cb13-60"></a> <span class="fu">}</span></span>
<span id="cb13-61"><a href="#cb13-61"></a> <span class="fu">},</span></span>
<span id="cb13-62"><a href="#cb13-62"></a> <span class="dt">"subjectOf"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-63"><a href="#cb13-63"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<span id="cb13-64"><a href="#cb13-64"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS Monitoring Location 08282300"</span><span class="fu">,</span></span>
<span id="cb13-65"><a href="#cb13-65"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Discharge data from USGS Streamgage at Rio Brazos at Fishtail Road NR Tierra Amarilla, NM"</span><span class="fu">,</span></span>
<span id="cb13-66"><a href="#cb13-66"></a> <span class="dt">"variableMeasured"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-67"><a href="#cb13-67"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"PropertyValue"</span><span class="fu">,</span></span>
<span id="cb13-68"><a href="#cb13-68"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"discharge"</span><span class="fu">,</span></span>
<span id="cb13-69"><a href="#cb13-69"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"Discharge in cubic feet per second"</span><span class="fu">,</span></span>
<span id="cb13-70"><a href="#cb13-70"></a> <span class="dt">"propertyID"</span><span class="fu">:</span> <span class="st">"https://www.wikidata.org/wiki/Q8737769"</span><span class="fu">,</span></span>
<span id="cb13-71"><a href="#cb13-71"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://en.wikipedia.org/wiki/Discharge_(hydrology)"</span><span class="fu">,</span></span>
<span id="cb13-72"><a href="#cb13-72"></a> <span class="dt">"unitText"</span><span class="fu">:</span> <span class="st">"cubic feet per second"</span><span class="fu">,</span></span>
<span id="cb13-73"><a href="#cb13-73"></a> <span class="dt">"qudt:hasQuantityKind"</span><span class="fu">:</span> <span class="st">"qudt-quantkinds:VolumeFlowRate"</span><span class="fu">,</span></span>
<span id="cb13-74"><a href="#cb13-74"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"qudt-units:FT3-PER-SEC"</span><span class="fu">,</span></span>
<span id="cb13-75"><a href="#cb13-75"></a> <span class="dt">"measurementTechnique"</span><span class="fu">:</span> <span class="st">"observation"</span><span class="fu">,</span></span>
<span id="cb13-76"><a href="#cb13-76"></a> <span class="dt">"measurementMethod"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-77"><a href="#cb13-77"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Discharge Measurements at Gaging Stations"</span><span class="fu">,</span></span>
<span id="cb13-78"><a href="#cb13-78"></a> <span class="dt">"publisher"</span><span class="fu">:</span> <span class="st">"U.S. Geological Survey"</span><span class="fu">,</span></span>
<span id="cb13-79"><a href="#cb13-79"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://doi.org/10.3133/tm3A8"</span></span>
<span id="cb13-80"><a href="#cb13-80"></a> <span class="fu">}</span></span>
<span id="cb13-81"><a href="#cb13-81"></a> <span class="fu">},</span></span>
<span id="cb13-82"><a href="#cb13-82"></a> <span class="dt">"temporalCoverage"</span><span class="fu">:</span> <span class="st">"2014-06-30/.."</span><span class="fu">,</span></span>
<span id="cb13-83"><a href="#cb13-83"></a> <span class="dt">"ssn-system:frequency"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb13-84"><a href="#cb13-84"></a> <span class="dt">"value"</span><span class="fu">:</span> <span class="st">"15"</span><span class="fu">,</span></span>
<span id="cb13-85"><a href="#cb13-85"></a> <span class="dt">"unitCode"</span><span class="fu">:</span> <span class="st">"qudt-units:Minute"</span></span>
<span id="cb13-86"><a href="#cb13-86"></a> <span class="fu">},</span></span>
<span id="cb13-87"><a href="#cb13-87"></a> <span class="dt">"distribution"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb13-88"><a href="#cb13-88"></a> <span class="fu">{</span></span>
<span id="cb13-89"><a href="#cb13-89"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span></span>
<span id="cb13-90"><a href="#cb13-90"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"USGS Instantaneous Values Service"</span></span>
<span id="cb13-91"><a href="#cb13-91"></a> <span class="st">"contentUrl"</span><span class="er">:</span> <span class="st">"https://waterservices.usgs.gov/nwis/iv/?sites=08282300&parameterCd=00060&format=rdb"</span><span class="fu">,</span></span>
<span id="cb13-92"><a href="#cb13-92"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb13-93"><a href="#cb13-93"></a> <span class="st">"text/tab-separated-values"</span></span>
<span id="cb13-94"><a href="#cb13-94"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb13-95"><a href="#cb13-95"></a> <span class="dt">"dc:conformsTo"</span><span class="fu">:</span> <span class="st">"https://pubs.usgs.gov/of/2003/ofr03123/6.4rdb_format.pdf"</span></span>
<span id="cb13-96"><a href="#cb13-96"></a> <span class="fu">}</span><span class="ot">,</span></span>
<span id="cb13-97"><a href="#cb13-97"></a> <span class="fu">{</span></span>
<span id="cb13-98"><a href="#cb13-98"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span></span>
<span id="cb13-99"><a href="#cb13-99"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"USGS SensorThings API"</span></span>
<span id="cb13-100"><a href="#cb13-100"></a> <span class="st">"contentUrl"</span><span class="er">:</span> <span class="st">"https://labs.waterdata.usgs.gov/sta/v1.1/Datastreams('0adb31f7852e4e1c9a778a85076ac0cf')?$expand=Thing,Observations"</span><span class="fu">,</span></span>
<span id="cb13-101"><a href="#cb13-101"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb13-102"><a href="#cb13-102"></a> <span class="st">"application/json"</span></span>
<span id="cb13-103"><a href="#cb13-103"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb13-104"><a href="#cb13-104"></a> <span class="dt">"dc:conformsTo"</span><span class="fu">:</span> <span class="st">"https://labs.waterdata.usgs.gov/docs/sensorthings/index.html"</span></span>
<span id="cb13-105"><a href="#cb13-105"></a> <span class="fu">}</span></span>
<span id="cb13-106"><a href="#cb13-106"></a> <span class="ot">]</span></span>
<span id="cb13-107"><a href="#cb13-107"></a> <span class="fu">}</span></span>
<span id="cb13-108"><a href="#cb13-108"></a><span class="fu">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</section>
<section id="sec-data-complete-example" class="level3" data-number="2.2.2">
<h3 data-number="2.2.2" class="anchored" data-anchor-id="sec-data-complete-example"><span class="header-section-number">2.2.2</span> Dataset-oriented</h3>
<div class="sourceCode" id="cb14"><pre class="sourceCode numberSource json number-lines code-with-copy"><code class="sourceCode json"><span id="cb14-1"><a href="#cb14-1"></a><span class="fu">{</span></span>
<span id="cb14-2"><a href="#cb14-2"></a> <span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb14-3"><a href="#cb14-3"></a> <span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"https://schema.org/"</span><span class="fu">,</span></span>
<span id="cb14-4"><a href="#cb14-4"></a> <span class="dt">"rdfs"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/2000/01/rdf-schema#"</span><span class="fu">,</span></span>
<span id="cb14-5"><a href="#cb14-5"></a> <span class="dt">"dc"</span><span class="fu">:</span> <span class="st">"http://purl.org/dc/terms/"</span><span class="fu">,</span></span>
<span id="cb14-6"><a href="#cb14-6"></a> <span class="dt">"qudt"</span><span class="fu">:</span> <span class="st">"http://qudt.org/schema/qudt/"</span><span class="fu">,</span></span>
<span id="cb14-7"><a href="#cb14-7"></a> <span class="dt">"qudt-units"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/unit/"</span><span class="fu">,</span></span>
<span id="cb14-8"><a href="#cb14-8"></a> <span class="dt">"qudt-quantkinds"</span><span class="fu">:</span> <span class="st">"http://qudt.org/vocab/quantitykind/"</span><span class="fu">,</span></span>
<span id="cb14-9"><a href="#cb14-9"></a> <span class="dt">"gsp"</span><span class="fu">:</span> <span class="st">"http://www.opengis.net/ont/geosparql#"</span><span class="fu">,</span></span>
<span id="cb14-10"><a href="#cb14-10"></a> <span class="dt">"locType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/sitetype"</span><span class="fu">,</span></span>
<span id="cb14-11"><a href="#cb14-11"></a> <span class="dt">"odm2var"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variablename/"</span><span class="fu">,</span></span>
<span id="cb14-12"><a href="#cb14-12"></a> <span class="dt">"odm2varType"</span><span class="fu">:</span> <span class="st">"http://vocabulary.odm2.org/variabletype/"</span><span class="fu">,</span></span>
<span id="cb14-13"><a href="#cb14-13"></a> <span class="dt">"hyf"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/"</span><span class="fu">,</span></span>
<span id="cb14-14"><a href="#cb14-14"></a> <span class="dt">"skos"</span><span class="fu">:</span> <span class="st">"https://www.opengis.net/def/schema/hy_features/hyf/HY_HydroLocationType"</span><span class="fu">,</span></span>
<span id="cb14-15"><a href="#cb14-15"></a> <span class="dt">"ssn"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/"</span><span class="fu">,</span></span>
<span id="cb14-16"><a href="#cb14-16"></a> <span class="dt">"ssn-system"</span><span class="fu">:</span> <span class="st">"http://www.w3.org/ns/ssn/systems/"</span></span>
<span id="cb14-17"><a href="#cb14-17"></a> <span class="fu">},</span></span>
<span id="cb14-18"><a href="#cb14-18"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"Dataset"</span><span class="fu">,</span></span>
<span id="cb14-19"><a href="#cb14-19"></a> <span class="dt">"@id"</span><span class="fu">:</span> <span class="st">"https://doi.org/10.4211/hs.4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb14-20"><a href="#cb14-20"></a> <span class="dt">"identifier"</span><span class="fu">:</span> <span class="st">"doi:hs.4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb14-21"><a href="#cb14-21"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Geoconnex Dataset Example: Data for Triangle Water Supply Dashboard"</span><span class="fu">,</span></span>
<span id="cb14-22"><a href="#cb14-22"></a> <span class="dt">"description"</span><span class="fu">:</span> <span class="st">"This is a dataset meant as an example of dataset-level schema.org markup for https://geoconnex.us. It uses as an example data from the NC Triangle Water Supply Dashboard, which collects and visualizes finished water deliveries by water utilities to their service areas in the North Carolina Research Triangle area"</span><span class="fu">,</span></span>
<span id="cb14-23"><a href="#cb14-23"></a> <span class="dt">"url"</span><span class="fu">:</span> <span class="st">"https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299"</span><span class="fu">,</span></span>
<span id="cb14-24"><a href="#cb14-24"></a> <span class="dt">"keywords"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb14-25"><a href="#cb14-25"></a> <span class="st">"water demand"</span><span class="ot">,</span></span>
<span id="cb14-26"><a href="#cb14-26"></a> <span class="st">"water supply"</span><span class="ot">,</span></span>
<span id="cb14-27"><a href="#cb14-27"></a> <span class="st">"geoconnex"</span></span>
<span id="cb14-28"><a href="#cb14-28"></a> <span class="ot">]</span><span class="fu">,</span></span>
<span id="cb14-29"><a href="#cb14-29"></a> <span class="dt">"license"</span><span class="fu">:</span> <span class="st">"https://creativecommons.org/licenses/by/4.0/"</span><span class="fu">,</span></span>
<span id="cb14-30"><a href="#cb14-30"></a> <span class="dt">"isAccessibleForFree"</span><span class="fu">:</span> <span class="st">"true"</span><span class="fu">,</span></span>
<span id="cb14-31"><a href="#cb14-31"></a> <span class="dt">"distribution"</span><span class="fu">:</span> <span class="fu">{</span></span>
<span id="cb14-32"><a href="#cb14-32"></a> <span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"DataDownload"</span><span class="fu">,</span></span>
<span id="cb14-33"><a href="#cb14-33"></a> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"HydroShare file URL"</span><span class="fu">,</span></span>
<span id="cb14-34"><a href="#cb14-34"></a> <span class="dt">"contentUrl"</span><span class="fu">:</span> <span class="st">"https://www.hydroshare.org/resource/4cf2a4298eca418f980201c1c5505299/data/contents/demand_over_time.csv"</span><span class="fu">,</span></span>
<span id="cb14-35"><a href="#cb14-35"></a> <span class="dt">"encodingFormat"</span><span class="fu">:</span> <span class="ot">[</span></span>
<span id="cb14-36"><a href="#cb14-36"></a> <span class="st">"text/csv"</span></span>