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. Se você não fizer a verificação até 26 de setembro de 2025, seu acesso poderá ser suspenso.
ee.Geometry.Point.withinDistance
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Retorna verdadeiro se e somente se as geometrias estiverem dentro de uma distância especificada.
| Uso | Retorna |
|---|
Point.withinDistance(right, distance, maxError, proj) | Booleano |
| Argumento | Tipo | Detalhes |
|---|
isso: left | Geometria | A geometria usada como o operando à esquerda da operação. |
right | Geometria | A geometria usada como o operando à direita da operação. |
distance | Ponto flutuante | O limite de distância. Se uma projeção for especificada, a distância será em unidades desse sistema de coordenadas projetado. Caso contrário, será em metros. |
maxError | ErrorMargin, padrão: null | A quantidade máxima de erro tolerada ao realizar qualquer reprojeção necessária. |
proj | Projeção, padrão: nulo | A projeção em que a operação será realizada. Se não for especificado, a operação será realizada em um sistema de coordenadas esféricas, e as distâncias lineares serão em metros na esfera. |
Exemplos
Editor de código (JavaScript)
// Define a Point object.
var point = ee.Geometry.Point(-122.082, 37.42);
// Define other inputs.
var inputGeom = ee.Geometry.Point(-122.090, 37.423);
// Apply the withinDistance method to the Point object.
var pointWithinDistance = point.withinDistance({'right': inputGeom, 'distance': 500, 'maxError': 1});
// Print the result to the console.
print('point.withinDistance(...) =', pointWithinDistance);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(point,
{'color': 'black'},
'Geometry [black]: point');
Map.addLayer(inputGeom,
{'color': 'blue'},
'Parameter [blue]: inputGeom');
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)
# Define a Point object.
point = ee.Geometry.Point(-122.082, 37.42)
# Define other inputs.
input_geom = ee.Geometry.Point(-122.090, 37.423)
# Apply the withinDistance method to the Point object.
point_within_distance = point.withinDistance(
right=input_geom, distance=500, maxError=1
)
# Print the result.
display('point.withinDistance(...) =', point_within_distance)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(point, {'color': 'black'}, 'Geometry [black]: point')
m.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m
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."],[],["The `withinDistance` method checks if two geometries (`left` and `right`) are within a specified `distance`. It returns `true` if they are, `false` otherwise. The distance is in meters or projected coordinate system units if a `projection` is provided. An optional `maxError` parameter allows for tolerance during reprojection. The method takes the `right` geometry, the `distance` threshold, `maxError`, and `projection` as input parameters to determine the result.\n"]]