-
Notifications
You must be signed in to change notification settings - Fork 4
/
mapml-ucrs-fulfillment-matrix.html
327 lines (270 loc) · 9.93 KB
/
mapml-ucrs-fulfillment-matrix.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
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>MapML UCR Fulfillment Matrix</title>
<style>
*, ::before, ::after {
box-sizing: border-box;
}
body {
/* scroll-padding-top: 100px; */
margin: 1rem;
font-family: 'Gill Sans', 'Gill Sans MT', Calibri, 'Trebuchet MS', sans-serif;
}
.container {
max-width: 50em;
margin: 0 auto;
}
dl {
display: flex;
flex-flow: row wrap;
}
dt {
flex-basis: 15%;
font-weight: bold;
}
dt::after {
content: ":";
}
dd {
flex-basis: 70%;
flex-grow: 1;
}
table {
width: 100%;
border-collapse: collapse;
margin-bottom: 1rem;
}
thead > tr {
background-color: gray;
color: white;
}
thead th {
background-color: gray;
position: sticky;
top: 0; /* required for stickiness */
border: 0!important;
}
table td,
table th {
padding: 0;
border: gray 1px solid;
font-size: 16px;
padding: 0.15rem 0.3rem;
}
table th {
text-align: start;
vertical-align: top;
font-weight: normal;
}
table td {
text-align: center;
}
th.ucr-category {
font-weight: bold;
background-color: aliceblue;
}
th.ucr-group {
font-size: larger;
font-weight: bold;
background-color: gainsboro;
padding: 0.5rem 0.3rem;
}
th.capability {
max-width: 15rem;
}
span.index {
font-size: smaller;
text-decoration: none;
/* background-color: gray; */
color: gray;
/* padding: 2px; */
}
td.pass,
td.full {
background-color: hsl(87, 60%, 60%);
}
td.partial,
td.limited,
td.not_applicable {
background-color: hsl(60, 100%, 87%);
}
td.fail,
td.none {
background-color: hsl(323, 68%, 83%);
}
td > ul {
list-style-position: inside;
padding: 0;
margin: 0.25rem;
text-align: start;
}
tr:target {
outline: 3px black solid;
/* scroll-padding-top: 2rem; */
}
body {
scroll-snap-type: y mandatory;
}
tr {
scroll-snap-align: start end;
}
.external_link::after,
a[href^="http"]:not(.github-mark)::after {
content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' aria-hidden='true' fill='cornflowerblue' width='14' height='14' viewBox='0 0 12 12'%3E%3Cpath d='M2,2 5,2 5,3 3,3 3,9 9,9 9,7 10,7 10,10 2,10M6.2,2 10,2 10,5.8 8.5,4.3 6.4,6.5 5.5,5.5 7.6,3.4'/%3E%3C/svg%3E");
margin: 0 0 0 2px;
}
#proposed_capabilities_container {
background-color: antiquewhite;
opacity: 0.75;
}
/* notes */
.annotated {
position: relative;
cursor: help;
padding: 1rem;
}
.annotated::after {
content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' height='16px' viewBox='0 0 24 24' width='16px' fill='%23000000'%3E%3Cpath d='M0 0h24v24H0V0z' fill='none'/%3E%3Cpath d='M11 7h2v2h-2zm0 4h2v6h-2zm1-9C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8z'/%3E%3C/svg%3E");
position: absolute;
top: 4px;
right: 4px;
}
td:not(.annotated) {
cursor: default;
}
span.note {
display: none;
cursor: initial;
background-color: #fff;
padding: 1rem;
margin-bottom: 1px;
filter: drop-shadow(0px 1px 1px #9d9d9d);
border-radius: 12px;
position: absolute;
z-index: 2;
width: 200px;
left: 50%;
bottom: 100%;
transform: translate(-50%, 0);
}
.annotated:first-of-type span.note {
transform: translate(calc(-50% + 75px), 0);
}
.annotated:last-of-type span.note {
transform: translate(calc(-50% - 75px), 0);
}
span.note::after {
content: "";
position: absolute;
top: 100%;
left: 50%;
margin-left: -7px;
border-width: 7px;
border-style: solid;
border-color: #fff transparent transparent transparent;
}
.annotated:first-of-type span.note::after {
left: calc(50% - 75px);
}
.annotated:last-of-type span.note::after {
left: calc(50% + 75px);
}
thead th {
z-index: 2;
}
.annotated:hover .note {
display: block;
}
/* Firefox bug(?) fix for borders not showing on `position: relative`
(annotated) <td> elements. */
@supports (-moz-appearance: none) {
td {
background-clip: padding-box;
}
}
.github-mark {
display: block;
width: max-content;
}
</style>
<script type="module" src="./main.js"></script>
</head>
<body>
<aside>
<a class="github-mark" href="https://github.com/Maps4HTML/UCR-MapML-Matrix" title="Github repository">
<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="45" height="45" fill="none" viewBox="0 0 1024 1024"><defs/><path fill="#1B1F23" fill-rule="evenodd" d="M512 0A511.9 511.9 0 000 512c0 226.6 146.6 418 350 485.8 25.7 4.4 35.3-11 35.3-24.4 0-12.1-.7-52.4-.7-95.3-128.6 23.7-161.9-31.4-172.1-60.2-5.8-14.7-30.7-60.1-52.5-72.3-18-9.6-43.5-33.3-.6-34 40.3-.6 69 37.2 78.7 52.6 46 77.4 119.7 55.6 149.1 42.2 4.5-33.3 18-55.7 32.6-68.5-113.9-12.8-233-57-233-252.8 0-55.7 20-101.7 52.6-137.6-5.2-12.8-23-65.3 5-135.7 0 0 43-13.4 140.9 52.5a475 475 0 01128-17.3c43.5 0 87 5.8 128 17.3 97.9-66.5 140.8-52.5 140.8-52.5 28.1 70.4 10.2 123 5.1 135.7a198.1 198.1 0 0152.5 137.6c0 196.5-119.7 240-233.6 252.8 18.5 16 34.5 46.7 34.5 94.7 0 68.5-.6 123.6-.6 140.8 0 13.5 9.6 29.5 35.2 24.4A512.8 512.8 0 001024 512C1024 229.1 794.9 0 512 0z" clip-rule="evenodd"/></svg>
</a>
</aside>
<div class="container">
<h1 id="title">MapML Use Case, Requirement, and Capability Matrix</h1>
<p>This document compares the capabilities of existing popular web mapping libraries, comparing and contrasting implementations with the <cite><a href="https://maps4html.org/MapML/spec/">MapML specification</a></cite> and the reference <a href="https://github.com/Maps4HTML/Web-Map-Custom-Element">MapML-Viewer custom-component polyfill</a>.</p>
<p>The capabilities indicated are split between common functionality that should be in any implementation (and thus suitable for standards) and aspirational features that should be natively implementated in browsers but which are not yet widely supported in most JavaScript libraries.</p>
<h2 id="background">Background</h2>
<p>Web maps provide a predominantly visual, spatial view into geographic data, for a wide variety of use cases. It is a complicated field, organically developed over many decades, with many different capabilities among the different web mapping <abbr title="Application Programming Interfaces">APIs</abbr>, <abbr title="Software Development Kits">SDKs</abbr>, and embeddable map widgets. The aim of this study is to assess which needs the existing solutions meet, which services they provide in common with each other, and what the levels of granularity are available in web mapping APIs.</p>
<p>This document is a summary of the more detailed <a href="https://maps4html.org/HTML-Map-Element-UseCases-Requirements">Use Cases and Requirements for Standardizing Web Maps</a> document developed by the W3C <a href="https://www.w3.org/community/maps4html/">Maps For HTML Community Group</a>. (References to that document in the tables below are indicated with an <span class="external_link">external link icon</span>.)</p>
<h2 id="technical-note">Technical Note</h2>
<p>The tables in this document are dynamically generated from a JSON file, <a href="https://github.com/Maps4HTML/UCR-MapML-Matrix/blob/main/mapml-ucr.json">mapml-ucr.json</a>, shared between this document and the <a href="https://maps4html.org/HTML-Map-Element-UseCases-Requirements">Use Cases and Requirements for Standardizing Web Maps</a> report. The shared JSON file is intended to keep the documents synchronized, but requires that client-side JavaScript is enabled.</p>
<h2 id="implementations">Implementations</h2>
<section id="implementation_container">
</section>
</div>
<h2 id="approved-capabilities">Approved capabilities</h2>
<section id="cap_table_container">
</section>
<h2 id="approved-capabilities">Proposed capabilities</h2>
<section id="proposed_capabilities_container">
<p><b>Note:</b> This is a placeholder section for future discussion of proposed capabilties.</p>
<table id="proposed-capabilities-table">
<thead>
<tr>
<th>proposed capability</th>
<th>category</th>
<th>MapML specification</th>
<th>Web-Map custom component</th>
<th>Bing Maps</th>
<th>D3</th>
<th>Google Maps</th>
<th>Leaflet.js</th>
<th>Mapbox</th>
<th>MapKit</th>
<th>OpenLayers</th>
<th>OpenStreetMap</th>
<th>TomTom</th>
</tr>
</thead>
<tbody>
<tr>
<th class="capability"><a href="https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#capability-default-map">Name and link to Github issue</a></th>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
</tr>
</tbody>
</table>
</section>
<section>
<h2 id="use-cases">Use Cases</h2>
<section id="use_case_container">
</section>
</section>
<!-- <section>
<h2 id="notes">Notes</h2>
<section id="note-1">
<h3 id="notes">Note 1:</h3>
<p>No additional JavaScript is require beside the script used in the polyfill</p>
<p><a href="#note-1-ref">back</a></p>
</section>
</section> -->
</body>
</html>