@basemaps/landing 7.9.0 → 7.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/build/attribution.d.ts +9 -10
  2. package/build/attribution.js +38 -50
  3. package/build/attribution.js.map +1 -1
  4. package/build/components/layer.switcher.dropdown.d.ts +8 -1
  5. package/build/components/layer.switcher.dropdown.js +75 -9
  6. package/build/components/layer.switcher.dropdown.js.map +1 -1
  7. package/build/components/map.label.d.ts +2 -0
  8. package/build/components/map.label.js +11 -1
  9. package/build/components/map.label.js.map +1 -1
  10. package/build/config.map.d.ts +6 -2
  11. package/build/config.map.js +37 -9
  12. package/build/config.map.js.map +1 -1
  13. package/build/tile.matrix.d.ts +5 -0
  14. package/build/tile.matrix.js +18 -0
  15. package/build/tile.matrix.js.map +1 -1
  16. package/build/url.d.ts +26 -0
  17. package/build/url.js.map +1 -1
  18. package/dist/docs/404.html +211 -0
  19. package/dist/docs/configuration/index.html +72 -0
  20. package/dist/docs/deployment/index.html +72 -0
  21. package/dist/docs/developer-guide/cli-methods/bundle-the-basemaps-config-file/index.html +669 -0
  22. package/dist/docs/developer-guide/index.html +74 -2
  23. package/dist/docs/developer-guide/run-basemaps-locally/index.html +678 -0
  24. package/dist/docs/developer-guide/server-methods/serve-basemaps-with-bundled-config-file/index.html +630 -0
  25. package/dist/docs/developer-guide/server-methods/serve-basemaps-with-collection-of-geotiff-files/index.html +584 -0
  26. package/dist/docs/examples/_overview/index.html +73 -1
  27. package/dist/docs/examples/leaflet.xyz.3857/index.html +72 -0
  28. package/dist/docs/examples/maplibre.opacity.3857/index.html +72 -0
  29. package/dist/docs/examples/maplibre.vector.3857/index.html +72 -0
  30. package/dist/docs/index.html +73 -1
  31. package/dist/docs/operator-guide/cog-quality/index.html +72 -0
  32. package/dist/docs/operator-guide/empty-tiles/index.html +72 -0
  33. package/dist/docs/operator-guide/gebco/index.html +72 -0
  34. package/dist/docs/operator-guide/index.html +72 -0
  35. package/dist/docs/operator-guide/quick-start/index.html +72 -0
  36. package/dist/docs/operator-guide/relief-shade/index.html +72 -0
  37. package/dist/docs/operator-guide/static/projection_beehive_fakenztm2000.webp +0 -0
  38. package/dist/docs/operator-guide/static/projection_beehive_nztm2000quad.webp +0 -0
  39. package/dist/docs/operator-guide/static/projection_nztm2000quad_0_0_0.webp +0 -0
  40. package/dist/docs/operator-guide/texture-shade/index.html +73 -1
  41. package/dist/docs/operator-guide/xyz-projection/index.html +598 -0
  42. package/dist/docs/quick-start/index.html +73 -1
  43. package/dist/docs/sitemap.xml +44 -19
  44. package/dist/docs/sitemap.xml.gz +0 -0
  45. package/dist/docs/user-guide/_get-started/index.html +73 -1
  46. package/dist/docs/user-guide/api-documentation/index.html +73 -1
  47. package/dist/docs/user-guide/api-documentation/{swagger-654fffa1.html → swagger-1c4e7946.html} +1 -1
  48. package/dist/docs/user-guide/technical-documentation/index.html +72 -0
  49. package/package.json +7 -7
@@ -0,0 +1,630 @@
1
+
2
+ <!DOCTYPE html>
3
+
4
+ <html class="no-js" lang="en">
5
+ <head>
6
+ <meta charset="utf-8"/>
7
+ <meta content="width=device-width,initial-scale=1" name="viewport"/>
8
+ <link href="http://localhost:8000/docs/developer-guide/server-methods/serve-basemaps-with-bundled-config-file/" rel="canonical"/>
9
+ <link href="../../cli-methods/bundle-the-basemaps-config-file/" rel="prev"/>
10
+ <link href="../serve-basemaps-with-collection-of-geotiff-files/" rel="next"/>
11
+ <link href="../../../assets/images/favicon.png" rel="icon"/>
12
+ <meta content="mkdocs-1.5.3, mkdocs-material-9.4.10" name="generator"/>
13
+ <title>Serve basemaps using a bundled config file - LINZ Basemaps</title>
14
+ <link href="../../../assets/stylesheets/main.fad675c6.min.css" rel="stylesheet"/>
15
+ <link href="../../../assets/stylesheets/palette.356b1318.min.css" rel="stylesheet"/>
16
+ <link crossorigin="" href="https://fonts.gstatic.com" rel="preconnect"/>
17
+ <link href="https://fonts.googleapis.com/css?family=Open+Sans:300,300i,400,400i,700,700i%7COpen+Sans+Mono:400,400i,700,700i&amp;display=fallback" rel="stylesheet"/>
18
+ <style>:root{--md-text-font:"Open Sans";--md-code-font:"Open Sans Mono"}</style>
19
+ <link href="../../../index.css" rel="stylesheet"/>
20
+ <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
21
+ <script id="__analytics">function __md_analytics(){function n(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],n("js",new Date),n("config",""),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){this.value&&n("event","search",{search_term:this.value})}),document$.subscribe(function(){var a=document.forms.feedback;if(void 0!==a)for(var e of a.querySelectorAll("[type=submit]"))e.addEventListener("click",function(e){e.preventDefault();var t=document.location.pathname,e=this.getAttribute("data-md-value");n("event","feedback",{page:t,data:e}),a.firstElementChild.disabled=!0;e=a.querySelector(".md-feedback__note [data-md-value='"+e+"']");e&&(e.hidden=!1)}),a.hidden=!1}),location$.subscribe(function(e){n("config","",{page_path:e.pathname})})});var e=document.createElement("script");e.async=!0,e.src="https://www.googletagmanager.com/gtag/js?id=",document.getElementById("__analytics").insertAdjacentElement("afterEnd",e)}</script>
22
+ <script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
23
+ </head>
24
+ <body data-md-color-accent="indigo" data-md-color-primary="indigo" data-md-color-scheme="default" dir="ltr">
25
+ <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
26
+ <input autocomplete="off" class="md-toggle" data-md-toggle="drawer" id="__drawer" type="checkbox"/>
27
+ <input autocomplete="off" class="md-toggle" data-md-toggle="search" id="__search" type="checkbox"/>
28
+ <label class="md-overlay" for="__drawer"></label>
29
+ <div data-md-component="skip">
30
+ <a class="md-skip" href="#serve-basemaps-using-a-bundled-config-file">
31
+ Skip to content
32
+ </a>
33
+ </div>
34
+ <div data-md-component="announce">
35
+ </div>
36
+ <header class="md-header md-header--shadow" data-md-component="header">
37
+ <nav aria-label="Header" class="md-header__inner md-grid">
38
+ <a aria-label="LINZ Basemaps" class="md-header__button md-logo" data-md-component="logo" href="../../.." title="LINZ Basemaps">
39
+ <img alt="logo" src="../../../linz-motif.svg"/>
40
+ </a>
41
+ <label class="md-header__button md-icon" for="__drawer">
42
+ <svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"></path></svg>
43
+ </label>
44
+ <div class="md-header__title" data-md-component="header-title">
45
+ <div class="md-header__ellipsis">
46
+ <div class="md-header__topic">
47
+ <span class="md-ellipsis">
48
+ LINZ Basemaps
49
+ </span>
50
+ </div>
51
+ <div class="md-header__topic" data-md-component="header-topic">
52
+ <span class="md-ellipsis">
53
+
54
+ Serve basemaps using a bundled config file
55
+
56
+ </span>
57
+ </div>
58
+ </div>
59
+ </div>
60
+ <form class="md-header__option" data-md-component="palette">
61
+ <input aria-label="Switch to dark mode" class="md-option" data-md-color-accent="indigo" data-md-color-media="(prefers-color-scheme: light)" data-md-color-primary="indigo" data-md-color-scheme="default" id="__palette_1" name="__palette" type="radio"/>
62
+ <label class="md-header__button md-icon" for="__palette_2" hidden="" title="Switch to dark mode">
63
+ <svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"></path></svg>
64
+ </label>
65
+ <input aria-label="Switch to light mode" class="md-option" data-md-color-accent="indigo" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-primary="indigo" data-md-color-scheme="slate" id="__palette_2" name="__palette" type="radio"/>
66
+ <label class="md-header__button md-icon" for="__palette_1" hidden="" title="Switch to light mode">
67
+ <svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"></path></svg>
68
+ </label>
69
+ </form>
70
+ <div class="md-header__source">
71
+ <a class="md-source" data-md-component="source" href="https://github.com/linz/basemaps" title="Go to repository">
72
+ <div class="md-source__icon md-icon">
73
+ <svg viewbox="0 0 448 512" xmlns="http://www.w3.org/2000/svg"><!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"></path></svg>
74
+ </div>
75
+ <div class="md-source__repository">
76
+ GitHub
77
+ </div>
78
+ </a>
79
+ </div>
80
+ </nav>
81
+ </header>
82
+ <div class="md-container" data-md-component="container">
83
+ <main class="md-main" data-md-component="main">
84
+ <div class="md-main__inner md-grid">
85
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation">
86
+ <div class="md-sidebar__scrollwrap">
87
+ <div class="md-sidebar__inner">
88
+ <nav aria-label="Navigation" class="md-nav md-nav--primary" data-md-level="0">
89
+ <label class="md-nav__title" for="__drawer">
90
+ <a aria-label="LINZ Basemaps" class="md-nav__button md-logo" data-md-component="logo" href="../../.." title="LINZ Basemaps">
91
+ <img alt="logo" src="../../../linz-motif.svg"/>
92
+ </a>
93
+ LINZ Basemaps
94
+ </label>
95
+ <div class="md-nav__source">
96
+ <a class="md-source" data-md-component="source" href="https://github.com/linz/basemaps" title="Go to repository">
97
+ <div class="md-source__icon md-icon">
98
+ <svg viewbox="0 0 448 512" xmlns="http://www.w3.org/2000/svg"><!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"></path></svg>
99
+ </div>
100
+ <div class="md-source__repository">
101
+ GitHub
102
+ </div>
103
+ </a>
104
+ </div>
105
+ <ul class="md-nav__list" data-md-scrollfix="">
106
+ <li class="md-nav__item">
107
+ <a class="md-nav__link" href="../../..">
108
+ <span class="md-ellipsis">
109
+ LINZ Basemaps
110
+ </span>
111
+ </a>
112
+ </li>
113
+ <li class="md-nav__item">
114
+ <a class="md-nav__link" href="../../../configuration/">
115
+ <span class="md-ellipsis">
116
+ Configuration
117
+ </span>
118
+ </a>
119
+ </li>
120
+ <li class="md-nav__item">
121
+ <a class="md-nav__link" href="../../../deployment/">
122
+ <span class="md-ellipsis">
123
+ Deployment
124
+ </span>
125
+ </a>
126
+ </li>
127
+ <li class="md-nav__item">
128
+ <a class="md-nav__link" href="../../../quick-start/">
129
+ <span class="md-ellipsis">
130
+ Quick start guide
131
+ </span>
132
+ </a>
133
+ </li>
134
+ <li class="md-nav__item md-nav__item--active md-nav__item--nested">
135
+ <input checked="" class="md-nav__toggle md-toggle" id="__nav_5" type="checkbox"/>
136
+ <div class="md-nav__link md-nav__container">
137
+ <a class="md-nav__link" href="../../">
138
+ <span class="md-ellipsis">
139
+ Developer guide
140
+ </span>
141
+ </a>
142
+ <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
143
+ <span class="md-nav__icon md-icon"></span>
144
+ </label>
145
+ </div>
146
+ <nav aria-expanded="true" aria-labelledby="__nav_5_label" class="md-nav" data-md-level="1">
147
+ <label class="md-nav__title" for="__nav_5">
148
+ <span class="md-nav__icon md-icon"></span>
149
+ Developer guide
150
+ </label>
151
+ <ul class="md-nav__list" data-md-scrollfix="">
152
+ <li class="md-nav__item">
153
+ <a class="md-nav__link" href="../../run-basemaps-locally/">
154
+ <span class="md-ellipsis">
155
+ How to run basemaps locally
156
+ </span>
157
+ </a>
158
+ </li>
159
+ <li class="md-nav__item md-nav__item--nested">
160
+ <input class="md-nav__toggle md-toggle" id="__nav_5_3" type="checkbox"/>
161
+ <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
162
+ <span class="md-ellipsis">
163
+ Cli methods
164
+ </span>
165
+ <span class="md-nav__icon md-icon"></span>
166
+ </label>
167
+ <nav aria-expanded="false" aria-labelledby="__nav_5_3_label" class="md-nav" data-md-level="2">
168
+ <label class="md-nav__title" for="__nav_5_3">
169
+ <span class="md-nav__icon md-icon"></span>
170
+ Cli methods
171
+ </label>
172
+ <ul class="md-nav__list" data-md-scrollfix="">
173
+ <li class="md-nav__item">
174
+ <a class="md-nav__link" href="../../cli-methods/bundle-the-basemaps-config-file/">
175
+ <span class="md-ellipsis">
176
+ Bundle the basemaps config file
177
+ </span>
178
+ </a>
179
+ </li>
180
+ </ul>
181
+ </nav>
182
+ </li>
183
+ <li class="md-nav__item md-nav__item--active md-nav__item--nested">
184
+ <input checked="" class="md-nav__toggle md-toggle" id="__nav_5_4" type="checkbox"/>
185
+ <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
186
+ <span class="md-ellipsis">
187
+ Server methods
188
+ </span>
189
+ <span class="md-nav__icon md-icon"></span>
190
+ </label>
191
+ <nav aria-expanded="true" aria-labelledby="__nav_5_4_label" class="md-nav" data-md-level="2">
192
+ <label class="md-nav__title" for="__nav_5_4">
193
+ <span class="md-nav__icon md-icon"></span>
194
+ Server methods
195
+ </label>
196
+ <ul class="md-nav__list" data-md-scrollfix="">
197
+ <li class="md-nav__item md-nav__item--active">
198
+ <input class="md-nav__toggle md-toggle" id="__toc" type="checkbox"/>
199
+ <label class="md-nav__link md-nav__link--active" for="__toc">
200
+ <span class="md-ellipsis">
201
+ Serve basemaps using a bundled config file
202
+ </span>
203
+ <span class="md-nav__icon md-icon"></span>
204
+ </label>
205
+ <a class="md-nav__link md-nav__link--active" href="./">
206
+ <span class="md-ellipsis">
207
+ Serve basemaps using a bundled config file
208
+ </span>
209
+ </a>
210
+ <nav aria-label="Table of contents" class="md-nav md-nav--secondary">
211
+ <label class="md-nav__title" for="__toc">
212
+ <span class="md-nav__icon md-icon"></span>
213
+ Table of contents
214
+ </label>
215
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
216
+ <li class="md-nav__item">
217
+ <a class="md-nav__link" href="#configure-the-basemapsserver-package">
218
+ <span class="md-ellipsis">
219
+ Configure the basemaps/server package
220
+ </span>
221
+ </a>
222
+ </li>
223
+ <li class="md-nav__item">
224
+ <a class="md-nav__link" href="#run-the-basemapsserver-package">
225
+ <span class="md-ellipsis">
226
+ Run the basemaps/server package
227
+ </span>
228
+ </a>
229
+ <nav aria-label="Run the basemaps/server package" class="md-nav">
230
+ <ul class="md-nav__list">
231
+ <li class="md-nav__item">
232
+ <a class="md-nav__link" href="#command">
233
+ <span class="md-ellipsis">
234
+ Command
235
+ </span>
236
+ </a>
237
+ </li>
238
+ <li class="md-nav__item">
239
+ <a class="md-nav__link" href="#parameters">
240
+ <span class="md-ellipsis">
241
+ Parameters
242
+ </span>
243
+ </a>
244
+ </li>
245
+ </ul>
246
+ </nav>
247
+ </li>
248
+ </ul>
249
+ </nav>
250
+ </li>
251
+ <li class="md-nav__item">
252
+ <a class="md-nav__link" href="../serve-basemaps-with-collection-of-geotiff-files/">
253
+ <span class="md-ellipsis">
254
+ Serve basemaps using a collection of GeoTIFF files
255
+ </span>
256
+ </a>
257
+ </li>
258
+ </ul>
259
+ </nav>
260
+ </li>
261
+ </ul>
262
+ </nav>
263
+ </li>
264
+ <li class="md-nav__item md-nav__item--nested">
265
+ <input class="md-nav__toggle md-toggle" id="__nav_6" type="checkbox"/>
266
+ <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
267
+ <span class="md-ellipsis">
268
+ Examples
269
+ </span>
270
+ <span class="md-nav__icon md-icon"></span>
271
+ </label>
272
+ <nav aria-expanded="false" aria-labelledby="__nav_6_label" class="md-nav" data-md-level="1">
273
+ <label class="md-nav__title" for="__nav_6">
274
+ <span class="md-nav__icon md-icon"></span>
275
+ Examples
276
+ </label>
277
+ <ul class="md-nav__list" data-md-scrollfix="">
278
+ <li class="md-nav__item">
279
+ <a class="md-nav__link" href="../../../examples/_overview/">
280
+ <span class="md-ellipsis">
281
+ Overview
282
+ </span>
283
+ </a>
284
+ </li>
285
+ <li class="md-nav__item">
286
+ <a class="md-nav__link" href="../../../examples/leaflet.xyz.3857/">
287
+ <span class="md-ellipsis">
288
+ Leaflet Raster Map
289
+ </span>
290
+ </a>
291
+ </li>
292
+ <li class="md-nav__item">
293
+ <a class="md-nav__link" href="../../../examples/maplibre.opacity.3857/">
294
+ <span class="md-ellipsis">
295
+ Maplibre Opacity Slider
296
+ </span>
297
+ </a>
298
+ </li>
299
+ <li class="md-nav__item">
300
+ <a class="md-nav__link" href="../../../examples/maplibre.vector.3857/">
301
+ <span class="md-ellipsis">
302
+ Maplibre Vector Map
303
+ </span>
304
+ </a>
305
+ </li>
306
+ </ul>
307
+ </nav>
308
+ </li>
309
+ <li class="md-nav__item md-nav__item--nested">
310
+ <input class="md-nav__toggle md-toggle" id="__nav_7" type="checkbox"/>
311
+ <div class="md-nav__link md-nav__container">
312
+ <a class="md-nav__link" href="../../../operator-guide/">
313
+ <span class="md-ellipsis">
314
+ Operator guide
315
+ </span>
316
+ </a>
317
+ <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
318
+ <span class="md-nav__icon md-icon"></span>
319
+ </label>
320
+ </div>
321
+ <nav aria-expanded="false" aria-labelledby="__nav_7_label" class="md-nav" data-md-level="1">
322
+ <label class="md-nav__title" for="__nav_7">
323
+ <span class="md-nav__icon md-icon"></span>
324
+ Operator guide
325
+ </label>
326
+ <ul class="md-nav__list" data-md-scrollfix="">
327
+ <li class="md-nav__item">
328
+ <a class="md-nav__link" href="../../../operator-guide/cog-quality/">
329
+ <span class="md-ellipsis">
330
+ COG Quality
331
+ </span>
332
+ </a>
333
+ </li>
334
+ <li class="md-nav__item">
335
+ <a class="md-nav__link" href="../../../operator-guide/empty-tiles/">
336
+ <span class="md-ellipsis">
337
+ Sparse Datasets and empty tiles
338
+ </span>
339
+ </a>
340
+ </li>
341
+ <li class="md-nav__item">
342
+ <a class="md-nav__link" href="../../../operator-guide/gebco/">
343
+ <span class="md-ellipsis">
344
+ Gebco re-project to NZTM2000Quad cog file
345
+ </span>
346
+ </a>
347
+ </li>
348
+ <li class="md-nav__item">
349
+ <a class="md-nav__link" href="../../../operator-guide/quick-start/">
350
+ <span class="md-ellipsis">
351
+ Running LINZ Basemaps - Quick Start
352
+ </span>
353
+ </a>
354
+ </li>
355
+ <li class="md-nav__item">
356
+ <a class="md-nav__link" href="../../../operator-guide/relief-shade/">
357
+ <span class="md-ellipsis">
358
+ Relief shade
359
+ </span>
360
+ </a>
361
+ </li>
362
+ <li class="md-nav__item">
363
+ <a class="md-nav__link" href="../../../operator-guide/texture-shade/">
364
+ <span class="md-ellipsis">
365
+ Texture shading
366
+ </span>
367
+ </a>
368
+ </li>
369
+ <li class="md-nav__item">
370
+ <a class="md-nav__link" href="../../../operator-guide/xyz-projection/">
371
+ <span class="md-ellipsis">
372
+ XYZ and projection math
373
+ </span>
374
+ </a>
375
+ </li>
376
+ </ul>
377
+ </nav>
378
+ </li>
379
+ <li class="md-nav__item md-nav__item--nested">
380
+ <input class="md-nav__toggle md-toggle" id="__nav_8" type="checkbox"/>
381
+ <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
382
+ <span class="md-ellipsis">
383
+ User guide
384
+ </span>
385
+ <span class="md-nav__icon md-icon"></span>
386
+ </label>
387
+ <nav aria-expanded="false" aria-labelledby="__nav_8_label" class="md-nav" data-md-level="1">
388
+ <label class="md-nav__title" for="__nav_8">
389
+ <span class="md-nav__icon md-icon"></span>
390
+ User guide
391
+ </label>
392
+ <ul class="md-nav__list" data-md-scrollfix="">
393
+ <li class="md-nav__item">
394
+ <a class="md-nav__link" href="../../../user-guide/_get-started/">
395
+ <span class="md-ellipsis">
396
+ Get started with LINZ Basemaps
397
+ </span>
398
+ </a>
399
+ </li>
400
+ <li class="md-nav__item">
401
+ <a class="md-nav__link" href="../../../user-guide/api-documentation/">
402
+ <span class="md-ellipsis">
403
+ API documentation
404
+ </span>
405
+ </a>
406
+ </li>
407
+ <li class="md-nav__item">
408
+ <a class="md-nav__link" href="../../../user-guide/technical-documentation/">
409
+ <span class="md-ellipsis">
410
+ Technical documentation and specifications
411
+ </span>
412
+ </a>
413
+ </li>
414
+ </ul>
415
+ </nav>
416
+ </li>
417
+ </ul>
418
+ </nav>
419
+ </div>
420
+ </div>
421
+ </div>
422
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc">
423
+ <div class="md-sidebar__scrollwrap">
424
+ <div class="md-sidebar__inner">
425
+ <nav aria-label="Table of contents" class="md-nav md-nav--secondary">
426
+ <label class="md-nav__title" for="__toc">
427
+ <span class="md-nav__icon md-icon"></span>
428
+ Table of contents
429
+ </label>
430
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
431
+ <li class="md-nav__item">
432
+ <a class="md-nav__link" href="#configure-the-basemapsserver-package">
433
+ <span class="md-ellipsis">
434
+ Configure the basemaps/server package
435
+ </span>
436
+ </a>
437
+ </li>
438
+ <li class="md-nav__item">
439
+ <a class="md-nav__link" href="#run-the-basemapsserver-package">
440
+ <span class="md-ellipsis">
441
+ Run the basemaps/server package
442
+ </span>
443
+ </a>
444
+ <nav aria-label="Run the basemaps/server package" class="md-nav">
445
+ <ul class="md-nav__list">
446
+ <li class="md-nav__item">
447
+ <a class="md-nav__link" href="#command">
448
+ <span class="md-ellipsis">
449
+ Command
450
+ </span>
451
+ </a>
452
+ </li>
453
+ <li class="md-nav__item">
454
+ <a class="md-nav__link" href="#parameters">
455
+ <span class="md-ellipsis">
456
+ Parameters
457
+ </span>
458
+ </a>
459
+ </li>
460
+ </ul>
461
+ </nav>
462
+ </li>
463
+ </ul>
464
+ </nav>
465
+ </div>
466
+ </div>
467
+ </div>
468
+ <div class="md-content" data-md-component="content">
469
+ <article class="md-content__inner md-typeset">
470
+ <h1 id="serve-basemaps-using-a-bundled-config-file">Serve <code>basemaps</code> using a bundled config file</h1>
471
+ <p>This guide shows you how to configure and run the <strong>basemaps/server</strong> package using a bundled config file. The config file specifies metadata regarding which imagery collections the package can serve from the <strong>LINZ AWS S3</strong> bucket.</p>
472
+ <h2 id="configure-the-basemapsserver-package">Configure the <code>basemaps/server</code> package</h2>
473
+ <p>The <strong>basemaps/server</strong> package requires a config file to serve the <strong>basemaps</strong> system.</p>
474
+ <p>You have two options. The first is to use the pre-generated config file stored in the <strong>LINZ AWS S3</strong> bucket. The second is to generate the config file yourself using the <strong>basemaps/cli</strong> package.</p>
475
+ <div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio"><input id="__tabbed_1_2" name="__tabbed_1" type="radio"><div class="tabbed-labels"><label for="__tabbed_1_1">Using the pre-generated config file</label><label for="__tabbed_1_2">Generating the config file yourself</label></div>
476
+ <div class="tabbed-content">
477
+ <div class="tabbed-block">
478
+ <div class="admonition abstract">
479
+ <p class="admonition-title">Path</p>
480
+ <p>To use the exisiting config file stored in the <strong>LINZ AWS S3</strong> bucket, note of the following path:</p>
481
+ <div class="tabbed-set tabbed-alternate" data-tabs="2:1"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio"><div class="tabbed-labels"><label for="__tabbed_2_1"><code>CONFIG_FILE</code></label></div>
482
+ <div class="tabbed-content">
483
+ <div class="tabbed-block">
484
+ <p>The absolute path to the latest config file stored in the <strong>LINZ AWS S3</strong> bucket.</p>
485
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a href="#__codelineno-0-1" id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nv">$CONFIG_FILE</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>s3://linz-basemaps/config/config-latest.json.gz
486
+ </span></code></pre></div>
487
+ </div>
488
+ </div>
489
+ </input></div>
490
+ </div>
491
+ </div>
492
+ <div class="tabbed-block">
493
+ <p>To generate the config file yourself, follow the <a href="../../cli-methods/bundle-the-basemaps-config-file/"><strong>Bundle the <code>basemaps</code> config file</strong></a> guide. Then, return to this section.</p>
494
+ <div class="admonition abstract">
495
+ <p class="admonition-title">Path</p>
496
+ <p>Once you have generated the config file, make a note of the file's location:</p>
497
+ <div class="tabbed-set tabbed-alternate" data-tabs="3:1"><input checked="checked" id="__tabbed_3_1" name="__tabbed_3" type="radio"><div class="tabbed-labels"><label for="__tabbed_3_1"><code>CONFIG_FILE</code></label></div>
498
+ <div class="tabbed-content">
499
+ <div class="tabbed-block">
500
+ <p>The path to the generated config file on your machine.</p>
501
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a href="#__codelineno-1-1" id="__codelineno-1-1" name="__codelineno-1-1"></a><span class="nv">$CONFIG_FILE</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">{</span>path_to<span class="o">}</span>/config.bundle.json
502
+ </span></code></pre></div>
503
+ </div>
504
+ </div>
505
+ </input></div>
506
+ </div>
507
+ </div>
508
+ </div>
509
+ </input></input></div>
510
+ <h2 id="run-the-basemapsserver-package">Run the <code>basemaps/server</code> package</h2>
511
+ <p>At this stage, you should have a path to a config file. Either, to that which you are sourcing from the <strong>LINZ AWS S3</strong> bucket, or, have generated using the <strong>basemaps/cli</strong> package.</p>
512
+ <div class="admonition abstract">
513
+ <p class="admonition-title">Path</p>
514
+ <p>The <strong>basemaps/server</strong> package provides a default function to serve the <strong>basemaps</strong> system. Take note of the following path:</p>
515
+ <div class="tabbed-set tabbed-alternate" data-tabs="4:1"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio"><div class="tabbed-labels"><label for="__tabbed_4_1"><code>BM_SERVER_BIN</code></label></div>
516
+ <div class="tabbed-content">
517
+ <div class="tabbed-block">
518
+ <p>The path to the <strong>bin</strong> folder of the <strong>basemaps/server</strong> package.</p>
519
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a href="#__codelineno-2-1" id="__codelineno-2-1" name="__codelineno-2-1"></a><span class="nv">$BM_SERVER_BIN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">$BM_REPO</span>/packages/server/bin
520
+ </span></code></pre></div>
521
+ </div>
522
+ </div>
523
+ </input></div>
524
+ </div>
525
+ <h3 id="command">Command</h3>
526
+ <p>Use the following command to run the <strong>basemaps</strong> system:</p>
527
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a href="#__codelineno-3-1" id="__codelineno-3-1" name="__codelineno-3-1"></a>node<span class="w"> </span><span class="nv">$BM_SERVER_BIN</span>/basemaps-server.cjs<span class="w"> </span>--config<span class="w"> </span><span class="nv">$CONFIG_FILE</span>
528
+ </span></code></pre></div>
529
+ <h3 id="parameters">Parameters</h3>
530
+ <div class="tabbed-set tabbed-alternate" data-tabs="5:1"><input checked="checked" id="__tabbed_5_1" name="__tabbed_5" type="radio"><div class="tabbed-labels"><label for="__tabbed_5_1"><code>--config</code></label></div>
531
+ <div class="tabbed-content">
532
+ <div class="tabbed-block">
533
+ <p>Specifies the location of the bundled config file to use.</p>
534
+ </div>
535
+ </div>
536
+ </input></div>
537
+ <!-- internal links -->
538
+ </article>
539
+ </div>
540
+ </div>
541
+ </main>
542
+ <footer class="md-footer">
543
+ <div class="md-footer-meta md-typeset">
544
+ <div class="md-footer-meta__inner md-grid">
545
+ <div class="md-copyright">
546
+ <div class="md-copyright__highlight">
547
+ <a href="https://www.linz.govt.nz/copyright">© CC BY 4.0 LINZ</a>
548
+ </div>
549
+
550
+
551
+ Made with
552
+ <a href="https://squidfunk.github.io/mkdocs-material/" rel="noopener" target="_blank">
553
+ Material for MkDocs
554
+ </a>
555
+ </div>
556
+ </div>
557
+ </div>
558
+ </footer>
559
+ </div>
560
+ <div class="md-dialog" data-md-component="dialog">
561
+ <div class="md-dialog__inner md-typeset"></div>
562
+ </div>
563
+ <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.indexes", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.f886a092.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
564
+ <script src="../../../assets/javascripts/bundle.6c14ae12.min.js"></script>
565
+ <script>document$.subscribe(() => {
566
+ window.update_swagger_ui_iframe_height = function (id) {
567
+ var iFrameID = document.getElementById(id);
568
+ if (iFrameID) {
569
+ full_height = (iFrameID.contentWindow.document.body.scrollHeight + 80) + "px";
570
+ iFrameID.height = full_height;
571
+ iFrameID.style.height = full_height;
572
+ }
573
+ }
574
+
575
+ let iframe_id_list = []
576
+ var iframes = document.getElementsByClassName("swagger-ui-iframe");
577
+ for (var i = 0; i < iframes.length; i++) {
578
+ iframe_id_list.push(iframes[i].getAttribute("id"))
579
+ }
580
+
581
+ let ticking = true;
582
+
583
+ document.addEventListener('scroll', function(e) {
584
+ if (!ticking) {
585
+ window.requestAnimationFrame(()=> {
586
+ let half_vh = window.innerHeight/2;
587
+ for(var i = 0; i < iframe_id_list.length; i++) {
588
+ let element = document.getElementById(iframe_id_list[i])
589
+ if(element==null){
590
+ return
591
+ }
592
+ let diff = element.getBoundingClientRect().top
593
+ if(element.contentWindow.update_top_val){
594
+ element.contentWindow.update_top_val(half_vh - diff)
595
+ }
596
+ }
597
+ ticking = false;
598
+ });
599
+ ticking = true;
600
+ }
601
+ });
602
+
603
+ const dark_scheme_name = "slate"
604
+
605
+ window.scheme = document.body.getAttribute("data-md-color-scheme")
606
+ const options = {
607
+ attributeFilter: ['data-md-color-scheme'],
608
+ };
609
+ function color_scheme_callback(mutations) {
610
+ for (let mutation of mutations) {
611
+ if (mutation.attributeName === "data-md-color-scheme") {
612
+ scheme = document.body.getAttribute("data-md-color-scheme")
613
+ var iframe_list = document.getElementsByClassName("swagger-ui-iframe")
614
+ for(var i = 0; i < iframe_list.length; i++) {
615
+ var ele = iframe_list.item(i);
616
+ if (ele) {
617
+ if (scheme === dark_scheme_name) {
618
+ ele.contentWindow.enable_dark_mode();
619
+ } else {
620
+ ele.contentWindow.disable_dark_mode();
621
+ }
622
+ }
623
+ }
624
+ }
625
+ }
626
+ }
627
+ observer = new MutationObserver(color_scheme_callback);
628
+ observer.observe(document.body, options);
629
+ })</script></body>
630
+ </html>