Skip to contents

Geocode reverso

2025-10-22

Source: vignettes/geocode_reverso.Rmd
geocode_reverso.Rmd

Geolocalização reversa: de coordenadas espaciais para endereços

A função geocode_reverso() permite fazer geolocalização reversa, isto é, a partir de um conjunto de coordenadas geográficas, encontrar os endereços correspondentes ou próximos. Essa funcionalidade pode ser útil, por exemplo, para identificar endereços próximos a pontos de interesse, como escolas, hospitais, ou locais de acidentes.

A função recebe como input um objeto espacial sf com geometria do tipo POINT. O resultado é um data frame com o endereço encontrado mais próximo de cada ponto de input, onde a coluna "distancia_metros" indica a distância entre coordenadas originais e os endereços encontrados.

library(geocodebr)
library(sf)
#> Linking to GEOS 3.10.2, GDAL 3.4.1, PROJ 8.2.1; sf_use_s2() is TRUE

# amostra de pontos espaciais
pontos <- readRDS(
  system.file("extdata/pontos.rds", package = "geocodebr")
)

pontos <- pontos[1:20,]

# geocode reverso
df_enderecos <- geocodebr::geocode_reverso(
  pontos = pontos,
  dist_max = 1000,
  verboso = FALSE,
  n_cores = 1
)

head(df_enderecos)
#> Simple feature collection with 3 features and 11 fields
#> Geometry type: POINT
#> Dimension:     XY
#> Bounding box:  xmin: -51.49634 ymin: -19.29416 xmax: -39.92601 ymax: 0.3649148
#> Geodetic CRS:  SIRGAS 2000
#>   id                                                      endereco_completo
#> 1  1                CORREGO BOA VISTA, 32 - LAJINHA, PANCAS - ES, 29750-000
#> 2 11 RODOVIA SAO MATEUS NOVA VENECIA, 6 - KM 13, SAO MATEUS - ES, 29944-025
#> 3 17        RAMAL MATAO DO PIACACA 1, 14 - PIACACA, SANTANA - AP, 68925-001
#>   estado  municipio                      logradouro numero       cep localidade
#> 1     ES     PANCAS               CORREGO BOA VISTA     32 29750-000    LAJINHA
#> 2     ES SAO MATEUS RODOVIA SAO MATEUS NOVA VENECIA      6 29944-025      KM 13
#> 3     AP    SANTANA        RAMAL MATAO DO PIACACA 1     14 68925-001    PIACACA
#>    lat_cnefe lon_cnefe distancia_metros                    geometry
#> 1 -19.291122 -40.73766         560.6426  POINT (-40.7334 -19.29416)
#> 2 -18.693834 -39.92420         373.7936 POINT (-39.92601 -18.69095)
#> 3   0.361638 -51.49637         364.7792 POINT (-51.49634 0.3649148)

Por padrão, a função busca pelo endereço mais próximo num raio aproximado de 1000 metros. No entanto, o usuário pode ajustar esse valor usando o parâmetro dist_max para definir a distância máxima (em metros) de busca. Se um ponto de input não tiver nenhum endereço próximo dentro do raio de busca, o ponto não é incluído no output.

Nota: A função geocode_reverso() requer que os dados do CNEFE estejam armazenados localmente. A primeita vez que a função é executada, ela baixa os dados do CNEFE e salva em um cache local na sua máquina. No total, esses dados somam cerca de 3 GB, o que pode fazer com que a primeira execução da função demore. Esses dados, no entanto, são salvos de forma persistente, logo eles são baixados uma única vez. Mais informações sobre o cache de dados aqui.