Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
Returns a Projection with the given base coordinate system and the given transform between projected coordinates and the base. If no transform is specified, the identity transform is assumed.
Usage
Returns
ee.Projection(crs, transform, transformWkt)
Projection
Argument
Type
Details
crs
Object
The base coordinate reference system of this Projection, given as a well-known authority code (e.g., 'EPSG:4326') or a WKT string.
transform
List, default: null
The transform between projected coordinates and the base coordinate system, specified as a 2x3 affine transform matrix in row-major order: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. May not specify both this and 'transformWkt'.
transformWkt
String, default: null
The transform between projected coordinates and the base coordinate system, specified as a WKT string. May not specify both this and 'transform'.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-13 UTC."],[[["\u003cp\u003e\u003ccode\u003eee.Projection\u003c/code\u003e returns a Projection object with a defined base coordinate system and an optional transform.\u003c/p\u003e\n"],["\u003cp\u003eThe base coordinate system (\u003ccode\u003ecrs\u003c/code\u003e) can be specified using an authority code (e.g., 'EPSG:4326') or a WKT string.\u003c/p\u003e\n"],["\u003cp\u003eThe transform between projected and base coordinates can be defined by a 2x3 affine transform matrix (\u003ccode\u003etransform\u003c/code\u003e) or a WKT string (\u003ccode\u003etransformWkt\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eIf no transform is provided, the identity transform is used, implying a direct mapping between projected and base coordinates.\u003c/p\u003e\n"]]],[],null,["# ee.Projection\n\nReturns a Projection with the given base coordinate system and the given transform between projected coordinates and the base. If no transform is specified, the identity transform is assumed.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------------------------------------|------------|\n| `ee.Projection(crs, `*transform* `, `*transformWkt*`)` | Projection |\n\n| Argument | Type | Details |\n|----------------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `crs` | Object | The base coordinate reference system of this Projection, given as a well-known authority code (e.g., 'EPSG:4326') or a WKT string. |\n| `transform` | List, default: null | The transform between projected coordinates and the base coordinate system, specified as a 2x3 affine transform matrix in row-major order: \\[xScale, xShearing, xTranslation, yShearing, yScale, yTranslation\\]. May not specify both this and 'transformWkt'. |\n| `transformWkt` | String, default: null | The transform between projected coordinates and the base coordinate system, specified as a WKT string. May not specify both this and 'transform'. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Construct projections.\n// Printing the projection will show the EPSG code if it is a direct match.\n//\n// e.g. You will see this for the string 'EPSG:3857'\n// type: Projection\n// crs: EPSG:3857\n// transform: [1,0,0,0,1,0]\n\nprint(ee.Projection('EPSG:3857')); // https://epsg.io/3857\nprint(ee.Projection('EPSG:4326')); // https://epsg.io/4326\n\n// WKT projection description for https://epsg.io/27572\nvar proj = ee.Projection(\n 'PROJCS[\"NTF (Paris) / Lambert zone II\", ' +\n ' GEOGCS[\"NTF (Paris)\", ' +\n ' DATUM[\"Nouvelle Triangulation Francaise (Paris)\", ' +\n ' SPHEROID[\"Clarke 1880 (IGN)\", 6378249.2, 293.4660212936269,'+\n ' AUTHORITY[\"EPSG\",\"7011\"]], ' +\n ' AUTHORITY[\"EPSG\",\"6807\"]], ' +\n ' PRIMEM[\"Paris\", 2.5969213, AUTHORITY[\"EPSG\",\"8903\"]], ' +\n ' UNIT[\"grade\", 0.015707963267948967], ' +\n ' AXIS[\"Geodetic longitude\", EAST], ' +\n ' AXIS[\"Geodetic latitude\", NORTH], ' +\n ' AUTHORITY[\"EPSG\",\"4807\"]], ' +\n ' PROJECTION[\"Lambert_Conformal_Conic_1SP\", AUTHORITY[\"EPSG\",\"9801\"]], ' +\n ' PARAMETER[\"central_meridian\", 0.0], ' +\n ' PARAMETER[\"latitude_of_origin\", 52.0], ' +\n ' PARAMETER[\"scale_factor\", 0.99987742], ' +\n ' PARAMETER[\"false_easting\", 600000.0], ' +\n ' PARAMETER[\"false_northing\", 2200000.0], ' +\n ' UNIT[\"m\", 1.0], ' +\n ' AXIS[\"Easting\", EAST], ' +\n ' AXIS[\"Northing\", NORTH], ' +\n ' AUTHORITY[\"EPSG\",\"27572\"]]');\nprint(proj); // crs: EPSG:27572\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Construct projections.\n# Printing the projection will show the EPSG code if it is a direct match.\n#\n# e.g. You will see this for the string 'EPSG:3857'\n# type: Projection\n# crs: EPSG:3857\n# transform: [1,0,0,0,1,0]\n\nprint(ee.Projection('EPSG:3857').getInfo()) # https://epsg.io/3857\nprint(ee.Projection('EPSG:4326').getInfo()) # https://epsg.io/4326\n\n# WKT projection description for https://epsg.io/27572\nproj = ee.Projection(\n 'PROJCS[\"NTF (Paris) / Lambert zone II\", ' +\n ' GEOGCS[\"NTF (Paris)\", ' +\n ' DATUM[\"Nouvelle Triangulation Francaise (Paris)\", ' +\n ' SPHEROID[\"Clarke 1880 (IGN)\", 6378249.2, 293.4660212936269,'+\n ' AUTHORITY[\"EPSG\",\"7011\"]], ' +\n ' AUTHORITY[\"EPSG\",\"6807\"]], ' +\n ' PRIMEM[\"Paris\", 2.5969213, AUTHORITY[\"EPSG\",\"8903\"]], ' +\n ' UNIT[\"grade\", 0.015707963267948967], ' +\n ' AXIS[\"Geodetic longitude\", EAST], ' +\n ' AXIS[\"Geodetic latitude\", NORTH], ' +\n ' AUTHORITY[\"EPSG\",\"4807\"]], ' +\n ' PROJECTION[\"Lambert_Conformal_Conic_1SP\", AUTHORITY[\"EPSG\",\"9801\"]], ' +\n ' PARAMETER[\"central_meridian\", 0.0], ' +\n ' PARAMETER[\"latitude_of_origin\", 52.0], ' +\n ' PARAMETER[\"scale_factor\", 0.99987742], ' +\n ' PARAMETER[\"false_easting\", 600000.0], ' +\n ' PARAMETER[\"false_northing\", 2200000.0], ' +\n ' UNIT[\"m\", 1.0], ' +\n ' AXIS[\"Easting\", EAST], ' +\n ' AXIS[\"Northing\", NORTH], ' +\n ' AUTHORITY[\"EPSG\",\"27572\"]]')\nprint(proj.getInfo()) # crs: EPSG:27572\n```"]]