Package pygeodesy :: Module webmercator |
[frames] | no frames]

# Module webmercator

Web Mercator (WM) class Wm and functions parseWM and toWm.

Pure Python implementation of a Web Mercator (aka Pseudo-Mercator) class and conversion functions for spherical and near-spherical earth models.

References Google Maps / Bing Maps Spherical Mercator Projection, Geomatics Guidance Note 7, part 2 and Implementation Practice Web Mercator Map Projection.

Version: 18.09.23

Classes
| Wm Web Mercator (WM) coordinate.

Functions
parseWM(strWM, radius=6378137.0, Wm=<class 'pygeodesy.webmercator.Wm'>, name=`'````'`) Parse a string representing a WM coordinate, consisting of easting, northing and an optional radius. |
toWm(latlon, lon=None, radius=6378137.0, Wm=<class 'pygeodesy.webmercator.Wm'>, name=`'````'`) Convert a lat-/longitude point to a WM coordinate. |

Function Details

### parseWM(strWM, radius=6378137.0, Wm=<class 'pygeodesy.webmercator.Wm'>, name=`'````'`) |
Parse a string representing a WM coordinate, consisting of easting, northing and an optional radius. Parameters: `strWM` - A WM coordinate (string). `radius` - Optional earth radius (meter). `Wm` - Optional Wm class to use (Wm) or None. `name` - Optional name (string). Returns: The WM coordinate (Wm) or 3-tuple (easting, northing, radius) if Wm is None. Raises: `ValueError` - Invalid strWM. Example:
    >>> u = parseWM('448251 5411932')
    >>> u.toStr2()  # [E:448251, N:5411932]

### toWm(latlon, lon=None, radius=6378137.0, Wm=<class 'pygeodesy.webmercator.Wm'>, name=`'````'`) |
Convert a lat-/longitude point to a WM coordinate. Parameters: `latlon` - Latitude (degrees) or an (ellipsoidal or spherical) geodetic LatLon point. `lon` - Optional longitude (degrees or None). `radius` - Optional earth radius (meter). `Wm` - Optional Wm class for the WM coordinate (Wm) or None. `name` - Optional name (string). Returns: The WM coordinate (Wm) or 3-tuple (easting, northing, radius) id Wm is None. Raises: `ValueError` - If lon value is missing, if latlon is not scalar, if latlon is beyond the valid WM range and rangerrors is set to True or if radius is invalid. Example:
    >>> p = LatLon(48.8582, 2.2945)  # 448251.8 5411932.7
    >>> w = toWm(p)  # 448252 5411933
    >>> p = LatLon(13.4125, 103.8667)  # 377302.4 1483034.8
    >>> w = toWm(p)  # 377302 1483035