aboutsummaryrefslogtreecommitdiff
path: root/operations/projections/webmerc.html
blob: bec082ca3808e38d51d93434f28d033763bc125e (plain)
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
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Web Mercator / Pseudo Mercator &mdash; PROJ 9.0.0 documentation</title>
      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
    <link rel="shortcut icon" href="../../_static/favicon.png"/>
    <link rel="canonical" href="https://proj.orgoperations/projections/webmerc.html"/>
  <!--[if lt IE 9]>
    <script src="../../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
        <script src="../../_static/jquery.js"></script>
        <script src="../../_static/underscore.js"></script>
        <script src="../../_static/doctools.js"></script>
        <script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
    <script src="../../_static/js/theme.js"></script>
    <link rel="author" title="About these documents" href="../../about.html" />
    <link rel="index" title="Index" href="../../genindex.html" />
    <link rel="search" title="Search" href="../../search.html" />
    <link rel="next" title="Werenskiold I" href="weren.html" />
    <link rel="prev" title="Wagner VII" href="wag7.html" /> 
</head>

<body class="wy-body-for-nav"> 
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search"  style="background: #353130" >
            <a href="../../index.html">
            <img src="../../_static/logo.png" class="logo" alt="Logo"/>
          </a>
              <div class="version">
                9.0.0
              </div>
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>
        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../about.html">About</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../news.html">News</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../download.html">Download</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../install.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../usage/index.html">Using PROJ</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../apps/index.html">Applications</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Coordinate operations</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html">Projections</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="adams_hemi.html">Adams Hemisphere in a Square</a></li>
<li class="toctree-l3"><a class="reference internal" href="adams_ws1.html">Adams World in a Square I</a></li>
<li class="toctree-l3"><a class="reference internal" href="adams_ws2.html">Adams World in a Square II</a></li>
<li class="toctree-l3"><a class="reference internal" href="aea.html">Albers Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="aeqd.html">Azimuthal Equidistant</a></li>
<li class="toctree-l3"><a class="reference internal" href="airy.html">Airy</a></li>
<li class="toctree-l3"><a class="reference internal" href="aitoff.html">Aitoff</a></li>
<li class="toctree-l3"><a class="reference internal" href="alsk.html">Modified Stereographic of Alaska</a></li>
<li class="toctree-l3"><a class="reference internal" href="apian.html">Apian Globular I</a></li>
<li class="toctree-l3"><a class="reference internal" href="august.html">August Epicycloidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="bacon.html">Bacon Globular</a></li>
<li class="toctree-l3"><a class="reference internal" href="bertin1953.html">Bertin 1953</a></li>
<li class="toctree-l3"><a class="reference internal" href="bipc.html">Bipolar conic of western hemisphere</a></li>
<li class="toctree-l3"><a class="reference internal" href="boggs.html">Boggs Eumorphic</a></li>
<li class="toctree-l3"><a class="reference internal" href="bonne.html">Bonne (Werner lat_1=90)</a></li>
<li class="toctree-l3"><a class="reference internal" href="calcofi.html">Cal Coop Ocean Fish Invest Lines/Stations</a></li>
<li class="toctree-l3"><a class="reference internal" href="cass.html">Cassini (Cassini-Soldner)</a></li>
<li class="toctree-l3"><a class="reference internal" href="cc.html">Central Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="ccon.html">Central Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="cea.html">Equal Area Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="chamb.html">Chamberlin Trimetric</a></li>
<li class="toctree-l3"><a class="reference internal" href="collg.html">Collignon</a></li>
<li class="toctree-l3"><a class="reference internal" href="col_urban.html">Colombia Urban</a></li>
<li class="toctree-l3"><a class="reference internal" href="comill.html">Compact Miller</a></li>
<li class="toctree-l3"><a class="reference internal" href="crast.html">Craster Parabolic (Putnins P4)</a></li>
<li class="toctree-l3"><a class="reference internal" href="denoy.html">Denoyer Semi-Elliptical</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck1.html">Eckert I</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck2.html">Eckert II</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck3.html">Eckert III</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck4.html">Eckert IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck5.html">Eckert V</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck6.html">Eckert VI</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqc.html">Equidistant Cylindrical (Plate Carrée)</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqdc.html">Equidistant Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqearth.html">Equal Earth</a></li>
<li class="toctree-l3"><a class="reference internal" href="euler.html">Euler</a></li>
<li class="toctree-l3"><a class="reference internal" href="fahey.html">Fahey</a></li>
<li class="toctree-l3"><a class="reference internal" href="fouc.html">Foucaut</a></li>
<li class="toctree-l3"><a class="reference internal" href="fouc_s.html">Foucaut Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="gall.html">Gall (Gall Stereographic)</a></li>
<li class="toctree-l3"><a class="reference internal" href="geos.html">Geostationary Satellite View</a></li>
<li class="toctree-l3"><a class="reference internal" href="gins8.html">Ginsburg VIII (TsNIIGAiK)</a></li>
<li class="toctree-l3"><a class="reference internal" href="gn_sinu.html">General Sinusoidal Series</a></li>
<li class="toctree-l3"><a class="reference internal" href="gnom.html">Gnomonic</a></li>
<li class="toctree-l3"><a class="reference internal" href="goode.html">Goode Homolosine</a></li>
<li class="toctree-l3"><a class="reference internal" href="gs48.html">Modified Stereographic of 48 U.S.</a></li>
<li class="toctree-l3"><a class="reference internal" href="gs50.html">Modified Stereographic of 50 U.S.</a></li>
<li class="toctree-l3"><a class="reference internal" href="guyou.html">Guyou</a></li>
<li class="toctree-l3"><a class="reference internal" href="hammer.html">Hammer &amp; Eckert-Greifendorff</a></li>
<li class="toctree-l3"><a class="reference internal" href="hatano.html">Hatano Asymmetrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="healpix.html">HEALPix</a></li>
<li class="toctree-l3"><a class="reference internal" href="rhealpix.html">rHEALPix</a></li>
<li class="toctree-l3"><a class="reference internal" href="igh.html">Interrupted Goode Homolosine</a></li>
<li class="toctree-l3"><a class="reference internal" href="igh_o.html">Interrupted Goode Homolosine (Oceanic View)</a></li>
<li class="toctree-l3"><a class="reference internal" href="imw_p.html">International Map of the World Polyconic</a></li>
<li class="toctree-l3"><a class="reference internal" href="isea.html">Icosahedral Snyder Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="kav5.html">Kavrayskiy V</a></li>
<li class="toctree-l3"><a class="reference internal" href="kav7.html">Kavrayskiy VII</a></li>
<li class="toctree-l3"><a class="reference internal" href="krovak.html">Krovak</a></li>
<li class="toctree-l3"><a class="reference internal" href="labrd.html">Laborde</a></li>
<li class="toctree-l3"><a class="reference internal" href="laea.html">Lambert Azimuthal Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="lagrng.html">Lagrange</a></li>
<li class="toctree-l3"><a class="reference internal" href="larr.html">Larrivee</a></li>
<li class="toctree-l3"><a class="reference internal" href="lask.html">Laskowski</a></li>
<li class="toctree-l3"><a class="reference internal" href="lcc.html">Lambert Conformal Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="lcca.html">Lambert Conformal Conic Alternative</a></li>
<li class="toctree-l3"><a class="reference internal" href="leac.html">Lambert Equal Area Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="lee_os.html">Lee Oblated Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="loxim.html">Loximuthal</a></li>
<li class="toctree-l3"><a class="reference internal" href="lsat.html">Space oblique for LANDSAT</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbt_s.html">McBryde-Thomas Flat-Polar Sine (No. 1)</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbt_fps.html">McBryde-Thomas Flat-Pole Sine (No. 2)</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfpp.html">McBride-Thomas Flat-Polar Parabolic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfpq.html">McBryde-Thomas Flat-Polar Quartic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfps.html">McBryde-Thomas Flat-Polar Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="merc.html">Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="mil_os.html">Miller Oblated Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mill.html">Miller Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="misrsom.html">Space oblique for MISR</a></li>
<li class="toctree-l3"><a class="reference internal" href="moll.html">Mollweide</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd1.html">Murdoch I</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd2.html">Murdoch II</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd3.html">Murdoch III</a></li>
<li class="toctree-l3"><a class="reference internal" href="natearth.html">Natural Earth</a></li>
<li class="toctree-l3"><a class="reference internal" href="natearth2.html">Natural Earth II</a></li>
<li class="toctree-l3"><a class="reference internal" href="nell.html">Nell</a></li>
<li class="toctree-l3"><a class="reference internal" href="nell_h.html">Nell-Hammer</a></li>
<li class="toctree-l3"><a class="reference internal" href="nicol.html">Nicolosi Globular</a></li>
<li class="toctree-l3"><a class="reference internal" href="nsper.html">Near-sided perspective</a></li>
<li class="toctree-l3"><a class="reference internal" href="nzmg.html">New Zealand Map Grid</a></li>
<li class="toctree-l3"><a class="reference internal" href="ob_tran.html">General Oblique Transformation</a></li>
<li class="toctree-l3"><a class="reference internal" href="ocea.html">Oblique Cylindrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="oea.html">Oblated Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="omerc.html">Oblique Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="ortel.html">Ortelius Oval</a></li>
<li class="toctree-l3"><a class="reference internal" href="ortho.html">Orthographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="patterson.html">Patterson</a></li>
<li class="toctree-l3"><a class="reference internal" href="pconic.html">Perspective Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="peirce_q.html">Peirce Quincuncial</a></li>
<li class="toctree-l3"><a class="reference internal" href="poly.html">Polyconic (American)</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp1.html">Putnins P1</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp2.html">Putnins P2</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp3.html">Putnins P3</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp3p.html">Putnins P3’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp4p.html">Putnins P4’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp5.html">Putnins P5</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp5p.html">Putnins P5’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp6.html">Putnins P6</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp6p.html">Putnins P6’</a></li>
<li class="toctree-l3"><a class="reference internal" href="qua_aut.html">Quartic Authalic</a></li>
<li class="toctree-l3"><a class="reference internal" href="qsc.html">Quadrilateralized Spherical Cube</a></li>
<li class="toctree-l3"><a class="reference internal" href="robin.html">Robinson</a></li>
<li class="toctree-l3"><a class="reference internal" href="rouss.html">Roussilhe Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="rpoly.html">Rectangular Polyconic</a></li>
<li class="toctree-l3"><a class="reference internal" href="s2.html">S2</a></li>
<li class="toctree-l3"><a class="reference internal" href="sch.html">Spherical Cross-track Height</a></li>
<li class="toctree-l3"><a class="reference internal" href="sinu.html">Sinusoidal (Sanson-Flamsteed)</a></li>
<li class="toctree-l3"><a class="reference internal" href="somerc.html">Swiss Oblique Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="stere.html">Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="sterea.html">Oblique Stereographic Alternative</a></li>
<li class="toctree-l3"><a class="reference internal" href="gstmerc.html">Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion)</a></li>
<li class="toctree-l3"><a class="reference internal" href="tcc.html">Transverse Central Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="tcea.html">Transverse Cylindrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="times.html">Times</a></li>
<li class="toctree-l3"><a class="reference internal" href="tissot.html">Tissot</a></li>
<li class="toctree-l3"><a class="reference internal" href="tmerc.html">Transverse Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="tobmerc.html">Tobler-Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="tpeqd.html">Two Point Equidistant</a></li>
<li class="toctree-l3"><a class="reference internal" href="tpers.html">Tilted perspective</a></li>
<li class="toctree-l3"><a class="reference internal" href="ups.html">Universal Polar Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="urm5.html">Urmaev V</a></li>
<li class="toctree-l3"><a class="reference internal" href="urmfps.html">Urmaev Flat-Polar Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="utm.html">Universal Transverse Mercator (UTM)</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg.html">van der Grinten (I)</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg2.html">van der Grinten II</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg3.html">van der Grinten III</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg4.html">van der Grinten IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="vitk1.html">Vitkovsky I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag1.html">Wagner I (Kavrayskiy VI)</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag2.html">Wagner II</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag3.html">Wagner III</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag4.html">Wagner IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag5.html">Wagner V</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag6.html">Wagner VI</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag7.html">Wagner VII</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Web Mercator / Pseudo Mercator</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#usage">Usage</a></li>
<li class="toctree-l4"><a class="reference internal" href="#parameters">Parameters</a></li>
<li class="toctree-l4"><a class="reference internal" href="#mathematical-definition">Mathematical definition</a></li>
<li class="toctree-l4"><a class="reference internal" href="#further-reading">Further reading</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="weren.html">Werenskiold I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wink1.html">Winkel I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wink2.html">Winkel II</a></li>
<li class="toctree-l3"><a class="reference internal" href="wintri.html">Winkel Tripel</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../conversions/index.html">Conversions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../transformations/index.html">Transformations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pipeline.html">The pipeline operator</a></li>
<li class="toctree-l2"><a class="reference internal" href="../operations_computation.html">Computation of coordinate operations between two CRS</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../resource_files.html">Resource files</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../geodesic.html">Geodesic calculations</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../development/index.html">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../specifications/index.html">Specifications</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../community/index.html">Community</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../faq.html">FAQ</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../zreferences.html">References</a></li>
</ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #353130" >
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../index.html">PROJ</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="../../index.html" class="icon icon-home"></a> &raquo;</li>
          <li><a href="../index.html">Coordinate operations</a> &raquo;</li>
          <li><a href="index.html">Projections</a> &raquo;</li>
      <li>Web Mercator / Pseudo Mercator</li>
      <li class="wy-breadcrumbs-aside">
              <a href="https://github.com/OSGeo/PROJ/edit/8.2/docs/source/operations/projections/webmerc.rst" class="fa fa-github"> Edit on GitHub</a>
      </li>
  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
        <a href="wag7.html" class="btn btn-neutral float-left" title="Wagner VII" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="weren.html" class="btn btn-neutral float-right" title="Werenskiold I" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
  </div>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
             
  <section id="web-mercator-pseudo-mercator">
<span id="webmerc"></span><h1>Web Mercator / Pseudo Mercator<a class="headerlink" href="#web-mercator-pseudo-mercator" title="Permalink to this headline">¶</a></h1>
<div class="versionadded">
<p><span class="versionmodified added">New in version 5.1.0.</span></p>
</div>
<p>The Web Mercator / Pseudo Mercator projection is a cylindrical map projection.
This is a variant of the regular <a class="reference internal" href="merc.html#merc"><span class="std std-ref">Mercator</span></a> projection, except that the computation
is done on a sphere, using the semi-major axis of the ellipsoid.</p>
<p>From <a class="reference external" href="https://en.wikipedia.org/wiki/Web_Mercator">Wikipedia</a>:</p>
<blockquote>
<div><p>This projection is widely used by the Web Mercator, Google Web Mercator,
Spherical Mercator, WGS 84 Web Mercator[1] or WGS 84/Pseudo-Mercator is a
variant of the Mercator projection and is the de facto standard for Web
mapping applications. […]
It is used by virtually all major online map providers […]
Its official EPSG identifier is EPSG:3857, although others have been used
historically.</p>
</div></blockquote>
<table class="docutils align-default">
<colgroup>
<col style="width: 27%" />
<col style="width: 73%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p><strong>Classification</strong></p></td>
<td><p>Cylindrical (non conformant if used with ellipsoid)</p></td>
</tr>
<tr class="row-even"><td><p><strong>Available forms</strong></p></td>
<td><p>Forward and inverse</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Defined area</strong></p></td>
<td><p>Global</p></td>
</tr>
<tr class="row-even"><td><p><strong>Alias</strong></p></td>
<td><p>webmerc</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Domain</strong></p></td>
<td><p>2D</p></td>
</tr>
<tr class="row-even"><td><p><strong>Input type</strong></p></td>
<td><p>Geodetic coordinates</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Output type</strong></p></td>
<td><p>Projected coordinates</p></td>
</tr>
</tbody>
</table>
<section id="usage">
<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
<p>Example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>$ echo 2 49 | proj +proj=webmerc +datum=WGS84
222638.98       6274861.39
</pre></div>
</div>
</section>
<section id="parameters">
<h2>Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>All parameters for the projection are optional, except the ellipsoid
definition, which is WGS84 for the typical use case of EPSG:3857.
In which case, the other parameters are set to their default 0 value.</p>
</div>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-ellps">
<span class="sig-name descname"><span class="pre">+ellps</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-ellps" title="Permalink to this definition">¶</a></dt>
<dd><p>The name of a built-in ellipsoid definition.</p>
<p>See <a class="reference internal" href="../../usage/ellipsoids.html#ellipsoids"><span class="std std-ref">Ellipsoids</span></a> for more information, or execute
<a class="reference internal" href="../../apps/proj.html#cmdoption-proj-le"><code class="xref std std-option docutils literal notranslate"><span class="pre">proj</span> <span class="pre">-le</span></code></a> for a list of built-in ellipsoid names.</p>
<p><em>Defaults to “GRS80”.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-lon_0">
<span id="cmdoption-arg-lon-0"></span><span class="sig-name descname"><span class="pre">+lon_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-lon_0" title="Permalink to this definition">¶</a></dt>
<dd><p>Longitude of projection center.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-x_0">
<span id="cmdoption-arg-x-0"></span><span class="sig-name descname"><span class="pre">+x_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-x_0" title="Permalink to this definition">¶</a></dt>
<dd><p>False easting.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-y_0">
<span id="cmdoption-arg-y-0"></span><span class="sig-name descname"><span class="pre">+y_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-y_0" title="Permalink to this definition">¶</a></dt>
<dd><p>False northing.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

</section>
<section id="mathematical-definition">
<h2>Mathematical definition<a class="headerlink" href="#mathematical-definition" title="Permalink to this headline">¶</a></h2>
<p>The formulas describing the Mercator projection are all taken from G. Evenden’s libproj manuals <span id="id1">[<a class="reference internal" href="../../zreferences.html#id11" title="Evenden, G. I. libproj4: A Comprehensive Library of Cartographic Projection Functions (Preliminary Draft). 2005. URL: https://github.com/OSGeo/PROJ/blob/master/docs/old/libproj.pdf.">Evenden2005</a>]</span>.</p>
<section id="forward-projection">
<h3>Forward projection<a class="headerlink" href="#forward-projection" title="Permalink to this headline">¶</a></h3>
<div class="math notranslate nohighlight">
\[x = \lambda\]</div>
<div class="math notranslate nohighlight">
\[y = \ln \left[ \tan \left(\frac{\pi}{4} + \frac{\phi}{2} \right) \right]\]</div>
</section>
<section id="inverse-projection">
<h3>Inverse projection<a class="headerlink" href="#inverse-projection" title="Permalink to this headline">¶</a></h3>
<div class="math notranslate nohighlight">
\[\lambda = {x}\]</div>
<div class="math notranslate nohighlight">
\[\phi = \frac{\pi}{2} - 2 \arctan \left[ e^{-y} \right]\]</div>
</section>
</section>
<section id="further-reading">
<h2>Further reading<a class="headerlink" href="#further-reading" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p><a class="reference external" href="https://en.wikipedia.org/wiki/Web_Mercator">Wikipedia</a></p></li>
</ol>
</section>
</section>


           </div>
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="wag7.html" class="btn btn-neutral float-left" title="Wagner VII" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="weren.html" class="btn btn-neutral float-right" title="Werenskiold I" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; Copyright 1983-2022.
      <span class="lastupdated">Last updated on 22 Mar 2022.
      </span></p>
  </div>

  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    provided by <a href="https://readthedocs.org">Read the Docs</a>.
   

</footer>
        </div>
      </div>
    </section>
  </div>
  <script>
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script> 

</body>
</html>