forked from HXLStandard/p-codes
-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathindex.html
310 lines (281 loc) · 20.3 KB
/
index.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
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="robots" content="noindex,follow">
<meta name="author" content="Edouard Legoupil @edouard_lgp">
<link rel="canonical" href="">
<meta property="og:locale" content="en_US">
<meta property="og:type" content="website">
<meta property="og:title" content="">
<meta property="og:url" content=" ">
<meta property="og:site_name" content="">
<meta property="og:image" content="">
<link rel="shortlink" href="">
<meta name="description" content="">
<title>Experimental p-coding site</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<link rel="shortcut icon" href="img/favicon.ico" type="image/x-icon">
<link rel="stylesheet" href="css/bootstrap.min.css" media="screen">
<link rel="stylesheet" href="css/bootswatch.min.css">
<link rel="stylesheet" href="css/font-humanitarian.css">
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="js/html5shiv.min.js"></script>
<script src="js/respond.min.js"></script>
<![endif]-->
</head>
<body>
<div class="navbar navbar-default navbar-fixed-top">
<div class="container">
<div class="navbar-header">
<a href="index.html" class="navbar-brand">Geographic p-codes</a>
<button class="navbar-toggle" type="button" data-toggle="collapse" data-target="#navbar-main">
<span class="icon-bar"></span>
</button>
</div>
<div class="navbar-collapse collapse" id="navbar-main">
<ul class="nav navbar-nav">
<li><a href="#Parameters">Parameters</a></li>
<li><a href="#Example">Example</a></li>
<li><a href="#Usage">Usage</a></li>
<li><a href="#Disclaimer">Disclaimer</a></li>
<li><a href="#Schema">Schema</a></li>
<li><a href="#Maintain">Maintain</a></li>
<li><a href="#Coverage">Coverage</a></li>
</ul>
<ul class="nav navbar-nav navbar-right">
<li><a href="http://data.unhcr.org/imtoolkit/" target="_blank">IM Tool kit</a></li>
<li><a href="http://maps.unhcr.org" target="_blank">Mapping Server</a></li>
<li><a href="http://data.unhcr.org/" target="_blank">Data portal</a></li>
</ul>
</div>
</div>
</div>
<div class="container">
<div class="row">
<div class="col-lg-12">
<div class="jumbotron">
<h1>Experimental p-coding site</h1>
<p>This site contains <a href="http://geojson.org/geojson-spec.html" target="_blank">GeoJson</a> files with names matching UNHCR <dfn>p-codes</dfn> (place codes)
for administrative units. All geographic files hosted in
<a href="https://help.github.com/articles/mapping-geojson-files-on-github" target="_blank">GitHub</a>
and managed under <a href="https://github.com/unhcr-mena/p-codes/commits/gh-pages" target="_blank">version control</a>.
This site is based on an idea from the
<a href="http://blog.okfn.org/2013/07/02/git-and-github-for-data/" target="_blank">Open Knowledge Institute</a>
and is forked from a <a href="http://hxlstandard.github.io/p-codes/" target="_blank">test from the Humanitarian Exchange Language (HXL) team</a></p>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Parameters">
<div class="page-header" >
<h3>Parameters</h3>
<dl>
<dt>{COUNTRY}</dt>
<dd>An ISO 3166-1 alpha3 code for the country, e.g. "JOR" for
Jordan.</dd>
<dt>{admin-level}</dt>
<dd>The requested admin-level (ADM1, ADM2, ADM3, ADM4) for the country.</dd>
<dt>{TYPE}</dt>
<dd>geoJson present boundaries using [multi]polygon.</dd>
</dl>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Example">
<div class="page-header" >
<h2>Example</h2>
<p>Download the GeoJSON polygon for admin level 1 of Jordan (Governorates):</p>
<blockquote>
<code><a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/JOR/ADM1.geojson" target="_blank">https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/JOR/ADM1.geojson</a></code>
</blockquote>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Usage">
<div class="page-header" >
<h2>Usage</h2>
<p>The files use the following naming scheme: <code>https://unhcr-mena.github.io/p-codes/geojson/{COUNTRY}/{admin-level}.geojson</code></p>
<p>The geoJSON map can also be placed in any HTML page that supports javascript (e.g., GitHub Pages) and embedded within an Iframe. For example, for Jordan, the URL to the raw file is accessible @ <code>https://raw.githubusercontent.com/unhcr-mena/p-codes/gh-pages/geojson/JOR/ADM1.geojson </code>.</p>
<iframe src="https://render.githubusercontent.com/view/geojson?url=https://raw.githubusercontent.com/unhcr-mena/p-codes/gh-pages/geojson/JOR/ADM1.geojson" width="620" height="420" frameborder="0"></iframe>
<p>By default, the embedded map size from <code>https://render.githubusercontent.com/view/geojson?url=https://raw.githubusercontent.com/unhcr-mena/p-codes/gh-pages/geojson/JOR/ADM1.geojson</code> is 420px x 620px, but you can customize the output by passing height and width variables as parameters at the end, such as <code>height=300&width=500</code>.</p>
<p>GeoJson is also supported by multiple softwares. With ArcGIS, you can use ArcMap's Data Interoperability tools or <a href="https://github.com/jasonbot/geojson-madness" target="_blank"> this tool</a>. You can also use <a href="https://blogs.esri.com/esri/arcgis/2014/12/16/arcgis-online-geojson/" target="_blank">ArcGIS online from ESRI</a></p>
<p>With <a href="https://www.qgis.org/en/site/forusers/download.html" target="_blank">Qgis</a>. <img src="img/qgisgeosjon.png"></img></p>
<p>With <a href="https://cran.r-project.org/" target="_blank">R statistical software</a> and use the SP library <code>library("sp"); url <- "https://raw.githubusercontent.com/unhcr-mena/p-codes/gh-pages/geojson/JOR/ADM1.geojson"; out <- geojson_read(url, verbose = FALSE); plot(out); </code></p>
<p>In addition a pcode reference file, <strong>itemsets.csv</strong>, is available for each country. This reference file can be used when creating <a href="http://xlsform.org/#cascade" target="_blank">Cascading selects</a> geographic questions using the <strong>select_one_external</strong> function within <a href="http://xlsform.org/#external" target="_blank">XLSFORM</a> questionnaires. The <strong>itemsets.csv</strong> file can be uploaded to <a href="https://kobo.unhcr.org" target="_blank">UNHCR Kobo Server</a> as a media file. It will be downloaded to any Kobo Collect like any other media file and saved to the [form-filename]-media folder. Clients like Kobo Collect load media files from the SD card and so a field data collection form with all locations within the country can load very quickly.</p>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Disclaimer">
<div class="page-header" >
<h2>Disclaimer</h2>
<p>The designations employed and the presentation of the material on this map do not imply the expression of any opinion whatsoever on the part of the United Nations concerning the legal status of any country, territory, city or area or of its authorities, or concerning the delimitation of its frontiers or boundaries. Every effort is made to ensure this map is free of errors but there is no warrant the map or its features are either spatially or temporally accurate or fit for a particular use. This map is provided without any warranty of any kind whatsoever, either express or implied.</p>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Schema">
<div class="page-header" >
<h2>Schema</h2>
<p>The schema is designed to allow for mapping of various thematic dataset. Unique ID from various systems are included.</p>
<ul>
<li><strong>gid</strong>: Unique ID for this dataset</li>
<li><strong>name </strong>: Admin Unit name</li>
<li><strong>namealt </strong>: Admin Unit alternative name</li>
<li><strong>namear </strong>: Admin Unit name in Arabic</li>
<li><strong>namearalt </strong>: Admin Unit alternative name in Arabic</li>
<li><strong>iso3 </strong>: Country Code ISO3</li>
<li><strong>idprogres </strong>: ID for UNHCR <a href="http://progres.unhcr.org" target="_blank">proGres refugee registration system</a></li>
<li><strong>idfocus </strong>: ID for UNHCR <a href="http://focus.unhcr.org" target="_blank">Focus system</a></li>
<li><strong>idocha </strong>: ID for OCHA <a href="https://www.humanitarianresponse.info/en/applications/data" target="_blank">Common Operational Dataset</a></li>
<li><strong>idgaul </strong>: ID for FAO <a href="http://www.fao.org/geonetwork/srv/en/metadata.show?id=12691" target="_blank">GAUL - Global Administrative Unit Database</a></li>
<li><strong>idnatural</strong>: ID for <a href="http://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-1-states-provinces/" target="_blank">Natural Earth</a></li>
<li><strong>idicrc </strong>: ID for ICRC</li>
</ul>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Maintain">
<div class="page-header" >
<h2>Maintain</h2>
<p>The files are text based and can be maintained directly in Github.</p>
<p>Files can be then edited through a regular GIS software or directly through in a an online editor like <a href="http://geojson.io" target="_blank">GEOJSON.io</a>.</p>
<p>The present repo can be forked and pull request can be submitted if files have changed.</p>
</div>
</div>
</div>
<div class="row">
<div class="col-lg-12" id="Coverage">
<h2>Current coverage</h2>
<h3>Syria Situation</h3>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/SYR">SYR</a></dt>
<dd>Syrian Arab Republic (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/SYR/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/SYR/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/IRQ">IRQ</a></dt>
<dd>Iraq (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/IRQ/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/IRQ/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/JOR">JOR</a></dt>
<dd>Jordan (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/JOR/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/JOR/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/LBN">LBN</a></dt>
<dd>Lebanon (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/LBN/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/LBN/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/TUR">TUR</a></dt>
<dd>Turkey (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/TUR/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/TUR/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<h3>Other Countries</h3>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/IRN">IRN</a></dt>
<dd>Iran (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/IRN/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/IRN/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/ISR">ISR</a></dt>
<dd>Israel(
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/ISR/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/ISR/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/PSE">PSE</a></dt>
<dd>State of Palestine (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/PSE/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/PSE/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<h3>Gulf Countries</h3>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/GCC">GCC</a></dt>
<dd>Gulf Cooperation Council - Includes: BAH: Bahrein; OMN: Oman; OMN: Oman; UAE: United Arab Emirates; SAU: Saudi Arabia; KWT: Kuwait; QAT: Qatar (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/GCC/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/GCC/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/YEM">YEM</a></dt>
<dd>Yemen (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/YEM/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/YEM/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<h3>North Africa</h3>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/MRT">MRT</a></dt>
<dd>Mauritania (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/MRT/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/MRT/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/ESH">ESH</a></dt>
<dd>Western Sahara (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/ESH/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/ESH/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/MAR">MAR</a></dt>
<dd>Morocco (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/MAR/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/MAR/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/DZA">DZA</a></dt>
<dd>Algeria (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/DZA/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/DZA/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/TUN">TUN</a></dt>
<dd>Tunisia (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/TUN/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/TUN/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/LBY">LBY</a></dt>
<dd>Libya (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/LBY/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/LBY/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
<dl>
<dt><a href="https://github.com/unhcr-mena/p-codes/tree/gh-pages/geojson/EGY">EGY</a></dt>
<dd>Egypt (
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/EGY/ADM1.geojson" target="_blank">ADM1</a>,
<a href="https://github.com/unhcr-mena/p-codes/blob/gh-pages/geojson/EGY/ADM2.geojson" target="_blank">ADM2</a>)</dd>
</dl>
</div>
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="row" class="footer">
<div class="col-lg-12">
<p>Based on <a href="http://getbootstrap.com" rel="nofollow">Bootstrap</a>. Icons from <a href="http://fortawesome.github.io/Font-Awesome/" rel="nofollow">Font Awesome</a>. Web fonts from <a href="http://www.google.com/webfonts" rel="nofollow">Google</a>.</p>
</div>
</div>
</footer>
<script src="https://code.jquery.com/jquery-1.10.2.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="js/bootswatch.js"></script>
</body>
</html>
</body>
</html>