Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.FeatureCollection.remap
Stay organized with collections
Save and categorize content based on your preferences.
Remaps the value of a specific property in a collection. Takes two parallel lists and maps values found in one to values in the other. Any element with a value that is not specified in the first list is dropped from the output collection.
| Usage | Returns | FeatureCollection.remap(lookupIn, lookupOut, columnName) | FeatureCollection |
| Argument | Type | Details | this: collection | FeatureCollection | The collection to be modified. |
lookupIn | List | The input mapping values. Restricted to strings and integers. |
lookupOut | List | The output mapping values. Must be the same size as lookupIn. |
columnName | String | The name of the property to remap. |
Examples
Code Editor (JavaScript)
// Classify features based on a string property.
// The 'nonsense' category gets dropped.
var fc = ee.FeatureCollection([
ee.Feature(ee.Geometry.Point([1, 2]), {isTree: 'Tree'}),
ee.Feature(ee.Geometry.Point([3, 4]), {isTree: 'NotTree'}),
ee.Feature(ee.Geometry.Point([5, 6]), {isTree: 'nonsense'}),
]);
var trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree');
print('remapped trees', trees);
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# Classify features based on a string property.
# The 'nonsense' category gets dropped.
fc = ee.FeatureCollection([
ee.Feature(ee.Geometry.Point([1, 2]), {'isTree': 'Tree'}),
ee.Feature(ee.Geometry.Point([3, 4]), {'isTree': 'NotTree'}),
ee.Feature(ee.Geometry.Point([5, 6]), {'isTree': 'nonsense'}),
])
trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree')
print('Remapped trees:', trees.getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eRemaps property values in a FeatureCollection using parallel lists for input and output mappings.\u003c/p\u003e\n"],["\u003cp\u003eElements with values not found in the input mapping list (\u003ccode\u003elookupIn\u003c/code\u003e) are excluded from the output.\u003c/p\u003e\n"],["\u003cp\u003eAccepts FeatureCollections, input and output mapping lists, and the property name for remapping as arguments.\u003c/p\u003e\n"],["\u003cp\u003eUseful for classifying features based on specific property values and simplifying data representation.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.remap\n\nRemaps the value of a specific property in a collection. Takes two parallel lists and maps values found in one to values in the other. Any element with a value that is not specified in the first list is dropped from the output collection.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------|-------------------|\n| FeatureCollection.remap`(lookupIn, lookupOut, columnName)` | FeatureCollection |\n\n| Argument | Type | Details |\n|--------------------|-------------------|---------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The collection to be modified. |\n| `lookupIn` | List | The input mapping values. Restricted to strings and integers. |\n| `lookupOut` | List | The output mapping values. Must be the same size as lookupIn. |\n| `columnName` | String | The name of the property to remap. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Classify features based on a string property.\n// The 'nonsense' category gets dropped.\nvar fc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point([1, 2]), {isTree: 'Tree'}),\n ee.Feature(ee.Geometry.Point([3, 4]), {isTree: 'NotTree'}),\n ee.Feature(ee.Geometry.Point([5, 6]), {isTree: 'nonsense'}),\n]);\n\nvar trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree');\nprint('remapped trees', trees);\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# Classify features based on a string property.\n# The 'nonsense' category gets dropped.\nfc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point([1, 2]), {'isTree': 'Tree'}),\n ee.Feature(ee.Geometry.Point([3, 4]), {'isTree': 'NotTree'}),\n ee.Feature(ee.Geometry.Point([5, 6]), {'isTree': 'nonsense'}),\n ])\n\ntrees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree')\nprint('Remapped trees:', trees.getInfo())\n```"]]