Skip to contents

Geocode reverso

2025-03-19

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 estado
#> 1  1         CORREGO BOA VISTA, 32 - LAJINHA, PANCAS - ES, 29750-000     ES
#> 2 11           RODOVIA ES 381, 6 - KM 13, SAO MATEUS - ES, 29944-025     ES
#> 3 17 RAMAL MATAO DO PIACACA 1, 14 - PIACACA, SANTANA - AP, 68925-001     AP
#>    municipio               logradouro numero       cep localidade  lat_cnefe
#> 1     PANCAS        CORREGO BOA VISTA     32 29750-000    LAJINHA -19.291122
#> 2 SAO MATEUS           RODOVIA ES 381      6 29944-025      KM 13 -18.689982
#> 3    SANTANA RAMAL MATAO DO PIACACA 1     14 68925-001    PIACACA   0.361638
#>   lon_cnefe distancia_metros                    geometry
#> 1 -40.73766         560.6493  POINT (-40.7334 -19.29416)
#> 2 -39.92413         225.5553 POINT (-39.92601 -18.69095)
#> 3 -51.49637         364.7801 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.