Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Algorithms.If
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Seleciona uma das entradas com base em uma condição, semelhante a uma construção if-then-else.
| Uso | Retorna |
|---|
ee.Algorithms.If(condition, trueCase, falseCase) | Objeto |
| Argumento | Tipo | Detalhes |
|---|
condition | Objeto, padrão: nulo | A condição que determina qual resultado é retornado. Se não for um booleano, ele será interpretado como um booleano pelas seguintes regras:
- Números iguais a 0 ou NaN são falsos.
- Strings, listas e dicionários vazios são falsos.
- Nulo é falso.
- Todo o resto é verdadeiro.
|
trueCase | Objeto, padrão: nulo | O resultado que será retornado se a condição for verdadeira. |
falseCase | Objeto, padrão: nulo | O resultado que será retornado se a condição for falsa. |
Exemplos
Editor de código (JavaScript)
print(ee.Algorithms.If(false, '*true*', '*false*')); // The string "*false*"
print(ee.Algorithms.If(true, '*true*', '*false*')); // The string "*true*"
// Consider using remap rather than If for tasks like numbers for classes.
print(ee.Algorithms.If(ee.String('Tree').compareTo('Tree'), 0, 1));
print(ee.Algorithms.If(ee.String('NotTree').compareTo('Tree'), 0, 1));
Configuração do Python
Consulte a página
Ambiente Python para informações sobre a API Python e como usar
geemap para desenvolvimento interativo.
import ee
import geemap.core as geemap
Colab (Python)
# The string "*false*"
print(ee.Algorithms.If(False, '*true*', '*false*').getInfo())
# The string "*true*"
print(ee.Algorithms.If(True, '*true*', '*false*').getInfo())
# Consider using remap rather than If for tasks like numbers for classes.
print(ee.Algorithms.If(ee.String('Tree').compareTo('Tree'), 0, 1).getInfo())
print(ee.Algorithms.If(ee.String('NotTree').compareTo('Tree'), 0, 1).getInfo())
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eee.Algorithms.If\u003c/code\u003e selects one of two input values based on a given condition, similar to an if-then-else statement.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econdition\u003c/code\u003e input determines the output, treating non-boolean values as true or false based on specific rules (e.g., 0 is false, empty strings are false).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etrueCase\u003c/code\u003e and \u003ccode\u003efalseCase\u003c/code\u003e represent the values returned when the condition is true or false, respectively.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003eee.Algorithms.If\u003c/code\u003e is versatile, using \u003ccode\u003eremap\u003c/code\u003e might be more efficient for tasks like assigning numerical values to classes.\u003c/p\u003e\n"]]],["The `ee.Algorithms.If` function selects one of two inputs based on a condition. It takes a `condition`, `trueCase`, and `falseCase`. If the `condition` is true, it returns `trueCase`; otherwise, it returns `falseCase`. Non-boolean conditions are evaluated: 0, NaN, empty collections, and null are false; everything else is true. Examples show using boolean values and string comparisons as conditions to determine the returned value. The `remap` function is suggested as an alternative for class-numbering tasks.\n"],null,["# ee.Algorithms.If\n\nSelects one of its inputs based on a condition, similar to an if-then-else construct.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------------|---------|\n| `ee.Algorithms.If(`*condition* `, `*trueCase* `, `*falseCase*`)` | Object |\n\n| Argument | Type | Details |\n|-------------|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `condition` | Object, default: null | The condition that determines which result is returned. If this is not a boolean, it is interpreted as a boolean by the following rules: - Numbers that are equal to 0 or a NaN are false. - Empty strings, lists and dictionaries are false. - Null is false. - Everything else is true. |\n| `trueCase` | Object, default: null | The result to return if the condition is true. |\n| `falseCase` | Object, default: null | The result to return if the condition is false. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint(ee.Algorithms.If(false, '*true*', '*false*')); // The string \"*false*\"\nprint(ee.Algorithms.If(true, '*true*', '*false*')); // The string \"*true*\"\n\n// Consider using remap rather than If for tasks like numbers for classes.\nprint(ee.Algorithms.If(ee.String('Tree').compareTo('Tree'), 0, 1));\nprint(ee.Algorithms.If(ee.String('NotTree').compareTo('Tree'), 0, 1));\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# The string \"*false*\"\nprint(ee.Algorithms.If(False, '*true*', '*false*').getInfo())\n\n# The string \"*true*\"\nprint(ee.Algorithms.If(True, '*true*', '*false*').getInfo())\n\n# Consider using remap rather than If for tasks like numbers for classes.\nprint(ee.Algorithms.If(ee.String('Tree').compareTo('Tree'), 0, 1).getInfo())\nprint(ee.Algorithms.If(ee.String('NotTree').compareTo('Tree'), 0, 1).getInfo())\n```"]]
